# Lugares Métodos relacionados con los lugares. # 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: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/getPlaces' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' ``` ##### Respuesta de ejemplo: ```JSON { "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: ```shell 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: ```JSON { "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: ```shell 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: ```JSON { "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: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/deletePlace' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \ --form 'idLugar="144825"' ``` ##### Respuesta de ejemplo: ```JSON { "status": 200, "data": "" } ``` **Nota:** Si en la respuesta de la solicitud aparece **"status": 30700** es un error al obtener los datos. ##### Respuesta de ejemplo: ```JSON { "status": 30700, "data": "" } ```