GIS Cloud (versión preliminar)
Este conector permite a los usuarios usar cualquier clave de autorización válida generada en GIS Cloud para acceder a una lista de sus proyectos de mapa, las capas definidas en y las características contenidas en esas capas. Para dar cabida a la naturaleza dinámica del esquema de características, el conector consultará dinámicamente el servicio para el esquema de características de una capa determinada.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con GIS Cloud Premium |
| URL | https://docs.giscloud.com/rest |
| Correo Electrónico | premiumsupport@giscloud.com |
| Metadatos del conector | |
|---|---|
| Publicador | Soluciones HandyGeo |
| Sitio web | http://www.giscloud.com |
| Directiva de privacidad | https://www.giscloud.com/privacy-policy/ |
| Categorías | Datos; Business Intelligence |
GIS Cloud es una plataforma SaaS que proporciona la mejor representación de mapas web y móviles de clase junto con un potente motor de formularios para facilitar todas sus necesidades de asignación colaborativa. El conector GIS Cloud proporciona un subconjunto de la API REST extensa y eficaz que permite a las automatizaciones impulsar la mayoría de los casos de uso comunes de un proyecto de Mapa. Este conector le permitirá enumerar, actualizar e interogate GIS Cloud Maps, Layers, Users y crear también características y archivos. Con este subconjunto, un usuario puede automatizar muchas actividades controladas por datos, como crear nuevas características para la inspección, crear informes, exportar datos para paneles, etc.
Prerrequisitos
Para usar el conector GIS Cloud, debe tener una cuenta de usuario de GIS Cloud con una suscripción de Map Editor; de lo contrario, muchas acciones no funcionarán.
Obtención de credenciales
La API REST de GIS Cloud se protege a través de una clave de API. La mayoría de los puntos de conexión REST no funcionarán sin una clave de API válida.
Para obtener una clave de API válida, vaya a https://manager.giscloud.com e inicie sesión con su cuenta de GIS Cloud.
En la parte superior derecha, haga clic en el nombre de usuario y seleccione "Mi cuenta" en el menú desplegable.
En el modal emergente, seleccione la pestaña "Acceso de API". Escriba un nombre descriptivo para la clave en el cuadro "Nueva descripción de clave de API" y haga clic en "Agregar clave". Un nuevo modal presentará la nueva clave de API que debe copiar y almacenar de forma segura, ya que nunca se volverá a mostrar.
Para obtener referencia adicional, consulte: https://docs.giscloud.com/rest#creating-an-api-key
Una vez completado, puede crear y probar el conector.
Introducción al conector
Cuando configure el conector por primera vez, las pruebas a través de la acción GetCurrentUser confirmarán que la clave de API es válida y devolverán los detalles de la cuenta asociados a la clave de API.
La mayoría de los usuarios usarán las acciones GetFeatures, CreateFeature, UpdateFeature y DeleteFeature en sus automatizaciones. Las otras acciones incluidas se usarán principalmente para la coordinación específica de la situación de un escenario de automatización determinado.
Un escenario típico de automatización es sincronizar las características de GIS Cloud desde la base de datos saaS en una tabla de Dataverse o una hoja de Excel con el fin de crear un panel de Power BI. En función de la estructura de datos, es posible que tenga que crear entidades personalizadas de Dataverse. Se recomienda que una automatización aproveche el where parámetro en la acción GetFeatures para limitar las características modificadas en los últimos días y solo sincronizarlas. Esto optimizará el rendimiento de la automatización.
Otro escenario típico de automatización es crear nuevas características de GIS Cloud automáticamente basadas en un origen de datos secundario, como Dynamics, SalesForce, solicitudes HTTP o incluso GIS Cloud. Para lograrlo, se recomienda que los usuarios consideren detenidamente cómo filtrar su origen de datos secundario para desencadenar la creación de la característica y haber finalizado su esquema de capa de destino de GIS Cloud antes de crear la automatización, ya que esto simplificará el desarrollo.
Un escenario de automatización típico final consiste en "archivar" automáticamente las características de GIS Cloud copiando las que cumplen determinados criterios (es decir, un estado específico establecido en una columna) en otra capa y, a continuación, al eliminar correctamente la característica original de GIS Cloud. Esto permite que un proyecto de Mapa activo se mantenga visualmente limpio sin pérdida de datos críticos.
Problemas y limitaciones conocidos
Compatibilidad de autenticación para PowerApps
Para ayudar a la compatibilidad con el componente de mapa PCF publicado por HandyGeo Services y para evitar preguntar a los usuarios de PowerApps las claves de API que no son fáciles de usar, hemos creado el conector para requerir que se especifique la clave de API con cada solicitud.
Esquema de datos dinámicos para puntos de conexión de características
Debido a las características geográficas de GIS Cloud que se originan en los datos cargados por el usuario, el esquema siempre es específico del conjunto de datos. Por lo tanto, el esquema para cargas y respuestas de todos los puntos de conexión de características siempre es dinámico y requiere compatibilidad con esquemas dinámicos en el producto de Office 365 que se está usando. Esto suele ser bien compatible con PowerAutomate, pero puede presentar desafíos en PowerApps.
Errores y soluciones comunes
Paginación del punto de conexión
Los puntos de conexión de GIS Cloud se limitan a un máximo de 5000 registros que se devuelven desde una sola solicitud. Aunque la API REST admite la paginación, actualmente no hay forma de incluir esto automáticamente en el comportamiento del conector.
Limitación de velocidad de API REST para la protección del servicio
Como debería esperarse con cualquier servicio de API REST de producción, si se realiza un número excesivo de solicitudes a la API de GIS Cloud en un breve período de tiempo, la respuesta será un código 5xx. Aunque no se define explícitamente un límite de velocidad específico, la API REST admitirá una velocidad de bucle paralela limitada (es decir, aprox. 20), pero es probable que las tasas altas produzcan errores significativos. Las respuestas con errores se pueden administrar con una directiva de reintento, pero las tasas excesivas provocarán problemas.
Falta el esquema de datos de características dinámicas
Debido a que el conector necesita buscar la definición de esquema, si los parámetros id. de capa o clave de API se pasan dinámicamente, la acción no podrá almacenar en caché el esquema de capas que requerirá que los usuarios administren manualmente el JSON devuelto. Reemplace el parámetro dinámico por un valor estático escribiendo en el cuadro de parámetros y el esquema se almacenará en caché adecuadamente.
Preguntas más frecuentes
La acción GetFeatures devuelve demasiadas características, ¿cómo puedo obtener solo las que quiero?
Se recomienda siempre que los usuarios aprovechen la where cláusula disponible en la acción GetFeatures. Esto puede dar cabida a la mayoría de las cláusulas compatibles con WHERE SQL. Para campos como la fecha de modificación del registro administrada por la plataforma, se recomienda que los usuarios prueben en la acción GetColumns para ver el nombre lógico verdadero de las columnas del sistema.
¿Cómo puedo cargar un archivo en el almacenamiento de propietarios del proyecto de asignación, no en mi propio almacenamiento?
Para la acción, UploadFileToPath, es esencial que si la clave de API no es para la cuenta de propietarios del proyecto de asignación que Destination Map ID (destination_map) el parámetro se rellena. Esto indica a la API REST de GIS Cloud que el archivo cargado no es para el usuario autenticado, sino para el propietario del proyecto de mapa especificado. Si el usuario no tiene permisos para acceder al mapa, la carga no se enrutará a la cuenta de oweners del mapa.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar característica |
Actualice un objeto de característica de GIS Cloud en un objeto layer. |
| Actualizar un mapa |
Actualizar un proyecto de mapa de la nube GIS |
| Actualizar una capa |
Actualice un objeto de capa de nube GIS. |
| Cargar un archivo |
Carga un archivo en el almacenamiento en la nube GIS. |
| Creación de una nueva característica en una capa |
Obtiene todos los objetos de características de la nube GIS en un objeto layer. |
| Eliminar caché de mapa |
Elimina la caché del icono de mapa para reflejar los cambios realizados a través de la API. |
| Eliminar función |
Elimina el objeto de característica GIS Cloud especificado de la capa. |
| Eliminar un mapa |
Eliminar un proyecto de mapa de la nube GIS |
| Eliminar una capa |
Elimine un objeto de capa de nube GIS. |
| Obtención de columnas para capa |
Obtener una lista de columnas de una capa |
| Obtener característica |
Obtiene un objeto de característica de la nube GIS en un objeto layer. |
| Obtener características en una capa |
Obtiene todos los objetos de características de la nube GIS en un objeto layer. |
| Obtener el objeto user actual |
Obtenga el objeto de usuario de GIS Cloud actual. |
| Obtener objeto de usuario por identificador |
Obtenga GIS Cloud User Object por el identificador de usuario. |
| Obtener todas las capas |
Obtenga todos los objetos de capa de nube GIS. |
| Obtener todas las capas de un mapa |
Obtenga todos los objetos de capa para un único objeto de mapa de nube GIS. |
| Obtener todos los mapas |
Obtenga todos los objetos de mapa en la nube gis. |
| Obtener un archivo |
Descargue un archivo de GIS Cloud Storage. |
| Obtener un archivo multimedia del campo Característica |
Obtenga un archivo multimedia de un campo de objeto de característica de la nube GIS en un objeto layer. |
| Obtener un mapa |
Obtenga un objeto gis Cloud Map. |
| Obtener una capa |
Obtenga todos los objetos de capa de nube GIS. |
| Quitar un archivo |
Quita un archivo en el almacenamiento en la nube GIS. |
| Representar un mapa |
Representar una imagen de un objeto de mapa de nube GIS. |
Actualizar característica
Actualice un objeto de característica de GIS Cloud en un objeto layer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de característica
|
feature_id | True | integer |
Identificador de característica interno que se usa para identificar una característica específica |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
payload
|
payload | dynamic |
Los nuevos datos de características que se van a actualizar |
Actualizar un mapa
Actualizar un proyecto de mapa de la nube GIS
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
|
Nombre
|
name | string |
Nombre del mapa |
Actualizar una capa
Actualice un objeto de capa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
Nombre
|
name | string |
Nombre de capa |
Cargar un archivo
Carga un archivo en el almacenamiento en la nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Datos de archivo
|
filedata | True | file |
Archivo que se va a cargar. |
|
Id. de mapa de destino
|
destination_map | integer |
Id. de mapa del mapa compartido. Si se establece, carga el archivo para asignar el almacenamiento de propietarios. |
|
|
Ruta de acceso al archivo
|
path_to_a_file | True | string |
Ruta de acceso relativa a un archivo específico |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
location
|
location | string |
Creación de una nueva característica en una capa
Obtiene todos los objetos de características de la nube GIS en un objeto layer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
payload
|
payload | dynamic |
Los datos a partir de los que se creará una nueva característica, todo lo que quede en blanco se creará como null. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
location
|
location | string |
Eliminar caché de mapa
Elimina la caché del icono de mapa para reflejar los cambios realizados a través de la API.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
|
Reinicializar desencadenador
|
init_trigger | True | integer |
Si se reinicializa el mapa antes de realizar la operación |
|
Lista de capas
|
layers | string |
Lista CSV de identificadores de capa que se van a incluir |
Eliminar función
Elimina el objeto de característica GIS Cloud especificado de la capa.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de característica
|
feature_id | True | integer |
Identificador de característica interno que se usa para identificar una característica específica |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
Eliminar un mapa
Eliminar un proyecto de mapa de la nube GIS
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
Eliminar una capa
Elimine un objeto de capa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
Obtención de columnas para capa
Obtener una lista de columnas de una capa
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
Obtener característica
Obtiene un objeto de característica de la nube GIS en un objeto layer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de característica
|
feature_id | True | integer |
Identificador de característica interno que se usa para identificar una característica específica |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
Incluir geometría
|
geometry | string |
Formato en el que se empaquetará la geometría. Valores posibles: 'wkt', 'kml' y 'gml' |
|
|
Proyección de EPSG
|
epsg | integer |
Código EPSG para la proyección de salida. si no se usa la proyección de mapa predeterminada especificada |
Devoluciones
Obtener características en una capa
Obtiene todos los objetos de características de la nube GIS en un objeto layer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
Incluir geometría
|
geometry | string |
Formato en el que se empaquetará la geometría. Valores posibles: 'wkt', 'kml' y 'gml' |
|
|
Proyección de EPSG
|
epsg | integer |
Código EPSG para la proyección de salida. si no se usa la proyección de mapa predeterminada especificada |
|
|
Límites espaciales
|
bounds | string |
Rectángulo de límite usado para el filtrado espacial |
|
|
SQL Where
|
where | string |
Tipo DE SQL donde se usa la cláusula para el filtrado de atributos |
|
|
Ordenar por
|
order_by | string |
Esto debe hacer referencia a columnas que existen en el objeto GIS Cloud de destino. De forma predeterminada, la columna está ordenada como Acending, pero la inclusión de :d esc invierte el orden. Order by, format "{created|modified|created}:[asc|desc]" Por ejemplo, order_by=accessed:desc |
|
|
Per-Page de elementos
|
perpage | integer |
Número de resultados por página que se va a mostrar (valor predeterminado: 100, máximo: 5000) |
|
|
Página No
|
page | integer |
Número de página de la respuesta |
|
|
Sin total
|
nototal | integer |
El total de resultados no se cuenta y se muestra; mejora el tiempo de respuesta; se usa para obtener la respuesta más rápido |
Devoluciones
Obtener el objeto user actual
Obtenga el objeto de usuario de GIS Cloud actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
Devoluciones
- Body
- User
Obtener objeto de usuario por identificador
Obtenga GIS Cloud User Object por el identificador de usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
ID de usuario
|
user_id | True | integer |
Identificador de usuario interno que se usa para identificar un usuario específico |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
Devoluciones
- Body
- User
Obtener todas las capas
Obtenga todos los objetos de capa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
|
|
Tipo de visibilidad
|
type | string |
Filtrar por visibilidad: 'public', 'private', 'shared' o 'private,shared' |
|
|
Ordenar por
|
order_by | string |
Esto debe hacer referencia a columnas que existen en el objeto GIS Cloud de destino. De forma predeterminada, la columna está ordenada como Acending, pero la inclusión de :d esc invierte el orden. Order by, format "{created|modified|created}:[asc|desc]" Por ejemplo, order_by=accessed:desc |
|
|
Per-Page de elementos
|
perpage | integer |
Número de resultados por página que se va a mostrar (valor predeterminado: 100, máximo: 5000) |
|
|
Página No
|
page | integer |
Número de página de la respuesta |
|
|
Sin total
|
nototal | True | integer |
El total de resultados no se cuenta y se muestra; mejora el tiempo de respuesta; se usa para obtener la respuesta más rápido |
Devoluciones
- Body
- Layers
Obtener todas las capas de un mapa
Obtenga todos los objetos de capa para un único objeto de mapa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
|
|
Ordenar por
|
order_by | string |
Esto debe hacer referencia a columnas que existen en el objeto GIS Cloud de destino. De forma predeterminada, la columna está ordenada como Acending, pero la inclusión de :d esc invierte el orden. Order by, format "{created|modified|created}:[asc|desc]" Por ejemplo, order_by=accessed:desc |
|
|
Per-Page de elementos
|
perpage | integer |
Número de resultados por página que se va a mostrar (valor predeterminado: 100, máximo: 5000) |
|
|
Página No
|
page | integer |
Número de página de la respuesta |
|
|
Sin total
|
nototal | integer |
El total de resultados no se cuenta y se muestra; mejora el tiempo de respuesta; se usa para obtener la respuesta más rápido |
Devoluciones
- Body
- Layers
Obtener todos los mapas
Obtenga todos los objetos de mapa en la nube gis.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Tipo de visibilidad
|
type | string |
Filtrar por visibilidad: 'public', 'private', 'shared' o 'private,shared' |
|
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
|
|
Ordenar por
|
order_by | string |
Esto debe hacer referencia a columnas que existen en el objeto GIS Cloud de destino. De forma predeterminada, la columna está ordenada como Acending, pero la inclusión de :d esc invierte el orden. Order by, format "{created|modified|created}:[asc|desc]" Por ejemplo, order_by=accessed:desc |
|
|
Per-Page de elementos
|
perpage | integer |
Número de resultados por página que se va a mostrar (valor predeterminado: 100, máximo: 5000) |
|
|
Página No
|
page | integer |
Número de página de la respuesta |
|
|
Sin total
|
nototal | integer |
El total de resultados no se cuenta y se muestra; mejora el tiempo de respuesta; se usa para obtener la respuesta más rápido |
Devoluciones
- Body
- Maps
Obtener un archivo
Descargue un archivo de GIS Cloud Storage.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Ruta de acceso al archivo
|
path_to_a_file | True | string |
Ruta de acceso relativa a un archivo específico |
|
Nombre de archivo
|
file_name | True | string |
Nombre de un archivo multimedia específico manguerado en el almacenamiento de SaaS |
Devoluciones
- response
- file
Obtener un archivo multimedia del campo Característica
Obtenga un archivo multimedia de un campo de objeto de característica de la nube GIS en un objeto layer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Descargar archivo
|
download | boolean |
Si se descarga directamente un archivo multimedia recuperado |
|
|
Ruta de acceso al archivo
|
path_to_a_file | True | string |
Ruta de acceso relativa a un archivo específico |
|
Nombre del campo
|
field_name | True | string |
Nombre de un campo de característica en una capa determinada |
|
Id. de característica
|
feature_id | True | integer |
Identificador de característica interno que se usa para identificar una característica específica |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
Devoluciones
- response
- file
Obtener un mapa
Obtenga un objeto gis Cloud Map.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
Devoluciones
- Body
- Map
Obtener una capa
Obtenga todos los objetos de capa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de capa
|
layer_id | True | integer |
Identificador de capa interno que se usa para identificar una capa específica |
|
Expandir atributos
|
expand | string |
Expanda la respuesta mediante una de las opciones de Enumeración. |
Devoluciones
- Body
- Layer
Quitar un archivo
Quita un archivo en el almacenamiento en la nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Nombre de archivo
|
file_name | True | string |
Nombre de un archivo multimedia específico manguerado en el almacenamiento de SaaS |
|
Ruta de acceso al archivo
|
path_to_a_file | True | string |
Ruta de acceso relativa a un archivo específico |
Representar un mapa
Representar una imagen de un objeto de mapa de nube GIS.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de API
|
API-Key | True | password |
Clave de API de GIS Cloud que se usa para autorizar la operación |
|
Id. de mapa
|
map_id | True | integer |
Identificador de mapa interno que se usa para identificar un mapa específico |
|
Ancho de imagen
|
width | number |
Ancho de imagen en píxeles |
|
|
Alto de la imagen
|
height | number |
Alto de imagen en píxeles |
|
|
Invalidar caché
|
invalidate | number |
Invalidar la caché |
|
|
Mostrar lista de capas
|
layerlist | number |
Establecer la lista de capas en visible en la imagen |
|
|
Imagen guardada
|
justgenerate | number |
Solo tiene que generar la imagen sin guardarla |
Devoluciones
- response
- file
Definiciones
Maps
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Total de registros
|
total | integer |
Recuento total de registros que se pueden recuperar |
|
Página actual
|
page | integer |
Número de la página que se devuelve |
|
Objetos de mapa
|
data | array of Map |
Matriz de objetos de mapa devueltos |
Mapa
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de mapa
|
id | integer |
Identificador interno de este mapa |
|
Nombre
|
name | string |
Nombre del mapa |
|
Owner (objeto)
|
owner | array of string |
Objeto propietario del mapa. Este valor solo aparece si el parámetro expand contiene la clave 'owner' |
|
Active
|
active | string |
¿Está activo el mapa? |
|
Derechos de autor
|
copyright | string |
Cadena de instrucciones copyright |
|
Proj4
|
proj4 | string |
Proyección de mapa de Proj4 |
|
Unidades proj4
|
units_proj4 | string |
Unidades de la definición de Proj4 |
|
Código EPSG
|
epsg | string |
Código de proyección de mapa de EPSG |
|
Unidades de mapa
|
units | string |
Unidades de mapa (medidor, pie o foot_us) |
|
Zoom máximo
|
maxzoom | string |
Zoom máximo |
|
Color de fondo
|
bgcolor | string |
Color de fondo del mapa |
|
Modificado en
|
modified | integer |
La última vez que se modificó el mapa (marca de tiempo de UNIX) |
|
Acceso a en
|
accessed | integer |
Se obtuvo acceso al mapa de la última vez (marca de tiempo de UNIX) |
|
Creado en
|
created | integer |
Hora en la que se creó el mapa (marca de tiempo de UNIX) |
|
Recuento de vistas
|
visited | string |
Número de vistas de mapa |
|
Archivado
|
archived | string |
Se ha archivado el mapa |
|
Identificador del recurso
|
resource_id | string |
resource_id |
|
Unidad de medida
|
measure_unit | string |
measure_unit |
|
Visible
|
visible | string |
visible |
|
Resource (objeto)
|
resource | Resource |
Asignar objeto de recurso |
|
Description
|
description | string |
Descripción del mapa |
|
mobileacess
|
mobileacess | string |
mobileacess |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
maptype
|
maptype | string |
maptype |
|
assets
|
assets | string |
assets |
|
Clasificación
|
rating | string |
Clasificación |
|
Compartir
|
share | string |
Compartir |
|
Límites xMin
|
bounds.xmin | float |
xmin |
|
Bounds xMax
|
bounds.xmax | float |
xmax |
|
Bounds yMin
|
bounds.ymin | float |
ymin |
|
Bounds yMax
|
bounds.ymax | float |
ymax |
|
límite
|
bound | string |
límite |
Resource
Asignar objeto de recurso
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador del recurso
|
id | integer |
Identificador interno de este recurso |
|
Tipo de recurso
|
type | string |
Tipo enumerado de Recurso |
|
Ubicación del recurso
|
location | string |
TBC con valores potencialmente NULL |
|
Identificador del recurso
|
target_resource_id | string |
resource_id |
|
Identificador del propietario del recurso
|
owner_id | string |
Identificador de usuario del usuario propietario de este recurso |
|
Identificador primario del recurso
|
parent_id | string |
TBC con valores potencialmente NULL |
|
Identificador de suscripción de pago de recursos
|
payment_subscription_id | string |
TBC con valores potencialmente NULL |
|
Identificador de pago de recursos
|
payment_id | string |
TBC con valores potencialmente NULL |
|
Identificador de pago de recursos Obs
|
payment_id_obs | string |
TBC con valores potencialmente NULL |
|
Recurso archivado
|
archived | string |
Indica si el recurso se ha archivado. |
|
Recurso deshabilitado
|
disabled | string |
TBC con valores potencialmente NULL |
|
Tiempo de acceso a recursos
|
access_time | object |
Hora a la que se accedió por última vez al recurso |
|
Modificado en
|
modified | integer |
Última vez que se modificó el recurso (marca de tiempo de UNIX) |
|
Creado en
|
created | integer |
Hora en la que se creó el recurso (marca de tiempo de UNIX) |
Capas
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Total de registros
|
total | integer |
Recuento total de registros que se pueden recuperar |
|
Página actual
|
page | integer |
Número de la página que se devuelve |
|
Objetos de capa
|
data | array of Layer |
Matriz de objetos de capa devueltos |
Nivel
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de capa
|
id | integer |
Identificador interno de la capa |
|
Nombre de capa
|
name | string |
Nombre de capa definido por el usuario |
|
Owner (objeto)
|
owner | array of string |
Objeto propietario de la capa, EXPANDABLE |
|
Tipo de origen de capa
|
source.type | string |
Tipo de datos proporcionados |
|
URI de origen de capa
|
source.src | string |
Cadena de URI que define dónde están los datos |
|
OnScale
|
onscale | string |
Establecer la escala en la que está visible la capa |
|
OffScale
|
offscale | string |
Establecer la escala en la que se oculta la capa |
|
Etiqueta de capa
|
label | string |
Nombre de atributo del origen de datos que se va a usar para una etiqueta de línea |
|
x min
|
x_min | string |
Coordenada X min enlazada de capa |
|
x Max
|
x_max | string |
Coordenada X máxima enlazada de capa |
|
y Min
|
y_min | string |
Coordenada Y mínima enlazada de capa |
|
y Max
|
y_max | string |
Coordenada máxima Y enlazada de capa |
|
Campo de texto de capa
|
textfield | string |
Nombre de atributo del origen de datos que se va a usar como campo de texto |
|
Modificado en
|
modified | integer |
La última vez que se modificó el mapa (marca de tiempo de UNIX) |
|
Creado en
|
created | integer |
Hora en la que se creó el mapa (marca de tiempo de UNIX) |
|
Estilos de capa
|
styles | string |
Objeto de estilo de capa complejo para el estilo de capa |
|
Capa alfa
|
alpha | string |
Transparencia de la capa |
|
Codificación de orígenes de datos de capa
|
encoding | string |
Codificación de orígenes de datos de capa |
|
Margen de texto de capa
|
margin | string |
Margen de campo de texto |
|
Visibilidad de capas
|
visible | string |
Controla la visibilidad de la capa, "t" o "f" |
|
Capa bloqueada
|
lock | string |
Controla la interactividad de la capa, 't' o 'f' |
|
Capa de trama
|
raster | string |
Layer es un origen de datos ráster, "t" o "f" |
|
Capa exportable
|
exportable | string |
Establecer si la capa se puede exportar, 't' o 'f' |
|
Capa combinada
|
merged | string |
La capa se combina |
|
Carpeta primaria de capa
|
parent | string |
Id. de capa de carpeta principal |
|
Información sobre herramientas de capa
|
tooltip | string |
Información sobre herramientas que aparece en las características de la capa mantiene el mouse sobre el mouse |
|
Ocultar geometría
|
hidegeometry | string |
Ocultar geometría de capa. Puede ser útil si queremos mostrar solo etiquetas, 't' o 'f' |
|
Menú emergente Usar información
|
use_info_window | string |
Mostrar información de características de capa en un elemento emergente de mapa, "t" o "f" |
|
Id. de origen de datos de capa
|
datasource_id | string |
Identificador de origen de datos del origen de datos de capa |
|
EPSG de capa
|
epsg | string |
Código EPSG del origen de datos |
|
Capa abierta
|
opened | string |
Para el valor booleano de apertura y cierre de la capa de carpeta, "t" o "f" |
|
Id. de recurso de capa
|
resource_id | string |
Identificador de recurso de la capa |
|
Id. de mapa de capa
|
map_id | string |
Id. de mapa al que pertenece la capa |
|
Tipo geom de capa
|
type | string |
Tipo de geometría de capa. Los valores posibles son 'point', 'line', 'polygon', 'tile' y 'wms'. |
|
Orden de la capa
|
order | integer |
Índice de capa Z |
|
Layer Options (objeto)
|
options | object |
Lista de opciones vinculadas a este recurso. Este valor solo aparece si el parámetro expand contiene la clave 'options' |
|
Nombre del formulario
|
form.name | string |
Nombre definido por el usuario del formulario adjunto |
|
Definición de formulario de capa
|
form.definition | string |
Definición del formulario adjunto a la capa |
|
Identificador de recurso de origen de datos
|
datasource.resource_id | string |
Identificador de recurso del origen de datos |
|
Tipo de origen de datos
|
datasource.type | string |
Tipo de origen de datos para la capa |
|
Identificador del propietario del origen de datos
|
datasource.owner_id | string |
owner_id |
|
permissions
|
datasource.permissions | array of string |
nombre |
|
Esquema de columna de capa
|
columns | object |
Mostrar columnas de origen de datos de capa, EXPANDABLE |
|
Subcapas
|
sublayers | array of Layer |
Matriz de objetos layer anidados dentro de esta capa |
Usuario
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID de usuario
|
id | integer |
Identificador de usuario único |
|
Tipo de usuario
|
type | string |
Tipo especificado de usuario |
|
Usuario activo
|
active | string |
Es el usuario activo, 't' o 'f' |
|
Nombre de usuario
|
username | string |
Nombre de usuario de los usuarios |
|
Nombre de usuario
|
firstname | string |
Nombre de los usuarios |
|
Apellidos de usuario
|
lastname | string |
Apellidos de los usuarios |
|
Identificador de propietario del usuario
|
owner_id | string |
Identificador de usuario del usuario propietario de este usuario |
|
Teléfono del usuario
|
phone | string |
Número de teléfono de usuarios |
|
Usuario móvil
|
mobile | string |
Número de móvil de usuarios |
|
Creado en
|
created | integer |
Hora en la que se creó el mapa (marca de tiempo de UNIX) |
|
Último inicio de sesión
|
lastlog | integer |
Hora en la que se creó el mapa (marca de tiempo de UNIX) |
|
Empresa de usuarios
|
company | string |
Nombre de la compañía de usuarios |
|
Dirección URL web de usuario
|
web | string |
Sitio web de perfil de usuario |
|
Email de usuario
|
string |
Dirección de correo electrónico de los usuarios |
|
|
Avatar de usuario
|
avatar | string |
Dirección URL para recuperar el avatar de los usuarios |
|
Idioma del usuario
|
language | string |
Idioma seleccionado por los usuarios |
|
Recuento de características de archivo
|
file_feature_count | string |
Recuento de características geográficas en el sistema de archivos |
|
Recuento de características de base de datos
|
db_feature_count | string |
Recuento de características geográficas en la base de datos |
|
Ráster de usuario almacenado
|
storage_raster | string |
Almacenamiento de archivos consumido por iconos de ráster |
|
User Storage Capcity
|
storage_total | string |
Almacenamiento total de archivos consumido |
|
Límite de características de usuario
|
feature_count_limit | string |
Recuento máximo de características con licencia |
|
Límite de ráster de usuario
|
storage_raster_limit | string |
Capacidad máxima de almacenamiento con licencia |
|
Inicios de la suscripción
|
subscription_begins | string |
Cuando comienza la suscripción de usuarios |
|
Expira la suscripción
|
subscription_expires | string |
Cuando finaliza la suscripción de usuarios |
|
Identificador de recurso de usuario
|
resource_id | string |
Identificador de recurso interno para este usuario |
|
Usuario modificado por última vez
|
modified | integer |
Hora de fecha y hora de última modificación (formato UNIX) |
|
Organización de usuarios
|
organization_id | string |
Id. de organización para este usuario |
|
OIDC de usuario
|
oidc | string |
OpenID Connect (protocolo de autenticación) |
|
Opciones de usuario
|
options | string |
Lista de opciones vinculadas al usuario. Este valor solo aparece si el parámetro 'expand' contiene la clave 'options' |
|
consents
|
consents | array of object |
Contratos de consentimiento del usuario (objeto) |
|
Propósito de consentimiento
|
consents.purpose | string |
El propósito del consentimiento solicitado |
|
Versión de consentimiento
|
consents.version | string |
Versión del consentimiento concedido |
|
Consentimiento acordado
|
consents.agreed | string |
¿Se concedió el consentimiento? |
archivo
Este es el tipo de datos básico "file".