Lugares

Métodos relacionados con los lugares.

Lista de lugares - getPlaces
Crear Lugar - createPlace
Actualizar lugar - updatePlace
Eliminar lugar - deletePlace

Lista de lugares - getPlaces

POST https://api.service24gps.com/api/v1/getPlaces

Obtiene el listado de todos los lugares que pertenecen al usuario o cliente.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getPlaces' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "idLugar": "556987",
            "nombre": "Colegio",
            "direccion": "Aztecas 158, Hab la Romana, 54030 Tlalnepantla de Baz, Méx.",
            "latitud": "19.550788",
            "longitud": "-99.191248",
            "descripcion": "Primaria y Secundaria",
            "telefono": "55 5390 2698",
            "email": "",
            "grupoLugar": "11",
            "grupo": "principal",
            "solo_mi_usuario": "48016",
            "icono": "/images/Lugares/new_596_retail_shop_building.png",
            "visible": 1
        }
    ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
idLugar	Identificador único del lugar en el sistema.	Entero
nombre	Nombre con el que se identificará el lugar en el sistema.	Cadena de Texto
direccion	Dirección en la que se ubica el lugar.	Cadena de Texto
latitud	Latitud correspondiente al lugar que se dará de alta.	Flotante
longitud	Longitud correspondiente al lugar que se dará de alta.	Flotante
descripcion	Comentario o descripción breve sobre el lugar.	Cadena de Texto
telefono	Número telefónico o de contacto vinculado al lugar.	Cadena de Texto
email	Dirección de correo electrónico vinculado al lugar.	Cadena de Texto
grupoLugar	Identificador del grupo al que pertenece el lugar.	Entero
grupo	Nombre del grupo al que pertenece el lugar	Cadena de texto
solo_mi_usuario	Indica si el lugar solo es visible para el usuario que la generó. 1 = Mi usuario 0 = Todos los usuarios	Entero
icono	Icono con el que se identificará el lugar en el sistema.	Cadena de Texto
visible	Indica si el lugar se debe o no mostrar. 1 = Mostrar 0 = Ocultar	Entero

Crear Lugar - createPlace

POST https://api.service24gps.com/api/v1/createPlace

Este método permite crear un lugar.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
nombre	Nombre con el que se identifica el lugar en el sistema.	Colegio 1
direccion	Dirección en la que se ubica el lugar.	Aztecas 158, Hab la Romana, 54030 Tlalnepantla de Baz, Méx.
latitud	Latitud correspondiente al lugar.	19.550788
longitud	Longitud correspondiente al lugar.	-99.191248
descripcion	Comentario o descripción breve sobre el lugar.	Primaria y Secundaria
telefono	Número telefónico o de contacto vinculado al lugar.	5553902698
email	Dirección de correo electrónico vinculado al lugar.	prueba@prueba.com
solo_mi_usuario	Indica si el lugar solo es visible para el usuario que la generó. 1 = Mi usuario 0 = Todos los usuarios	0
icono	Icono con el que se identificará el lugar en el sistema.	/images/Lugares/new_596_retail_shop_building.png

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/createPlace' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idLugar="556987"' \
--form 'nombre="Colegio 1"' \
--form 'direccion="Aztecas 158, Hab la Romana, 54030 Tlalnepantla de Baz, Méx."' \
--form 'latitud="19.550788"' \
--form 'longitud="-99.191248"' \
--form 'descripcion="Primaria y Secundaria"' \
--form 'telefono="5553902698"' \
--form 'email="prueba@prueba.com"' \
--form 'solo_mi_usuario="0"' \
--form 'icono="/images/Lugares/new_596_retail_shop_building.png"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": "12345"
}

Actualizar lugar - updatePlace

POST https://api.service24gps.com/api/v1/updatePlace

Este método permite actualizar cualquier valor de un lugar.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idLugar	Identificador único del lugar en el sistema.	556987
nombre	Nombre con el que se identifica el lugar en el sistema.	Colegio 2
direccion	Dirección en la que se ubica el lugar.	Aztecas 158, Hab la Romana, 54030 Tlalnepantla de Baz, Méx.
latitud	Latitud correspondiente al lugar.	19.550788
longitud	Longitud correspondiente al lugar.	-99.191248
descripcion	Comentario o descripción breve sobre el lugar.	Primaria y Secundaria
telefono	Número telefónico o de contacto vinculado al lugar.	5553902698
email	Dirección de correo electrónico vinculado al lugar.
solo_mi_usuario	Indica si el lugar solo es visible para el usuario que la generó. 1 = Mi usuario 0 = Todos los usuarios	0
icono	Icono con el que se identificará el lugar en el sistema.	/images/Lugares/new_596_retail_shop_building.png

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/updatePlace' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idLugar="556987"' \
--form 'nombre="Colegio 2"' \
--form 'direccion="Aztecas 158, Hab la Romana, 54030 Tlalnepantla de Baz, Méx."' \
--form 'latitud="19.550788"' \
--form 'longitud="-99.191248"' \
--form 'descripcion="Primaria y Secundaria"' \
--form 'telefono="55 5390 2698"' \
--form 'email=""' \
--form 'solo_mi_usuario="0"' \
--form 'icono="/images/Lugares/new_596_retail_shop_building.png"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": ""
}

Eliminar lugar - deletePlace

POST https://api.service24gps.com/api/v1/deletePlace

Este método permite eliminar un lugar especifico.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idLugar	Identificador único de la geocerca en el sistema.	144825

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/deletePlace' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'idLugar="144825"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": ""
}

Nota: Si en la respuesta de la solicitud aparece "status": 30700 es un error al obtener los datos.

Respuesta de ejemplo:

{
    "status": 30700,
    "data": ""
}