Integración con GPS
Especificación Funcional del WebService
Para integrar los datos del GPS a su plataforma, se construyo una API con las siguientes especificaciones:
• Debe tener un método que se llame GetGpsEvents.
• El servicio deberá brindar un tiempo de respuesta siempre de 10 minutos, ya que el intervalo de
invocaciones será de 10o minutos.
• Se envian todas las posiciones no descargadas desde el último acceso al servicio.
• Las posiciones son entregadas ordenadas de más antiguas a más recientes.
Integración de GPS
Especificación Técnica del WebService
Nombre del Método del Servicio: GetGPSEvents
• Parámetros de Entrada • Parámetros de Salida
Campo Tipo de Dato Descripción Campo Tipo de parámetro Tipo de Dato Descripción
User VarChar(15) Usuario de acceso. IMEI Obligatorio VarChar(25) Identificador único del dispositivo
Debe ser
EventType Opcional Integer Se esperan los siguiente valores:
proporcionado por
el proveedor GPS
1 – Unidad Detenida
Password VarChar(15) Contraseña. Debe
2 – Motor Apagado.
ser proporcionada 3 – Exceso de Velocidad.
por el proveedor 4– Unidad en Movimiento.
GPS 5 – Motor Encendido.
DTime Obligatorio DateTime Formato yyyy/mm/dd hh:mm:ss en zona Horaria UTC 0
Lat Obligatorio Float Latitud del posicionamiento del dispositivo
Lon Obligatorio Float Longitud del posicionamiento del dispositivo
Speed Obligatorio Float Velocidad en Km/hr. (Esto debe ser independiente a
cualquier configuración que el transportista pudiera
modificar)
Address Opcional VarChar(500) Descripción Geográfica de Posicionamiento
Plate Obligatorio VarChar(15) Placa del vehículo o plataforma sin guiones, espacios ni
caracteres especiales.
Course Opcional Float Curso del vehículo, en grados.
En este caso especifico del usuario del Sr. Ivan Monroy es:
[Link]
Ejemplo de esquema esperado en RESPONSE
<s:Envelope xmlns:s="[Link]
<s:Body>
<GetGPSEventsResponse xmlns="[Link]
<GetGPSEventsResult xmlns:i="[Link]
<Event>
<IMEI>123456789012345</IMEI>
<EventType>5</EventType>
<DTime>2017-05-16T12:15:58Z</DTime>
<Lat>25.7678665</Lat>
<Lon>-100.2917066</Lon>
<Speed>16</Speed>
<Address>3.1km NNE of México, Nuevo León, San Nicolás de los Garza, Ciudad San Nicolás de los Garza</Address>
<Plate>386EW6</Plate>
<Course>74</Course>
</Event>
<Event>
<IMEI>234567890123456</IMEI>
<EventType>2</EventType>
<DTime>2017-05-16T12:16:58Z</DTime>
<Lat>25.7730961</Lat>
<Lon>-100.289433</Lon>
<Speed>52</Speed>
<Address>3.7km NNE of México, Nuevo León, San Nicolás de los Garza, Ciudad San Nicolás de los Garza</Address>
<Plate>386EW9</Plate>
<Course>23</Course>
</Event>
</GetGPSEventsResult>
</GetGPSEventsResponse>
</s:Body>
</s:Envelope>
NOTA: En caso de que no se tenga la información de algún parámetro opcional (ejemplo Address), el TAG NO deberá omitirse, deberá
enviarse vacío (<Address /> o <Address></Adrdress>)