Nuvem do GIS (versão prévia)
Esse conector permite que os usuários usem qualquer chave de autorização válida gerada no GIS Cloud para acessar uma lista de seus Projetos de Mapa, as Camadas definidas dentro e os recursos contidos nessas camadas. Para acomodar a natureza dinâmica do esquema de recurso, o conector consultará dinamicamente o serviço para o esquema de recursos de uma determinada camada.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao GIS Cloud Premium |
| URL | https://docs.giscloud.com/rest |
| premiumsupport@giscloud.com |
| Metadados do conector | |
|---|---|
| Publicador | Soluções HandyGeo |
| Site | http://www.giscloud.com |
| Política de privacidade | https://www.giscloud.com/privacy-policy/ |
| Categorias | Dados; Business Intelligence |
O GIS Cloud é uma plataforma SaaS que fornece o melhor na renderização de mapa móvel e web de classe, juntamente com um poderoso mecanismo de formulários para facilitar todas as suas necessidades de mapeamento colaborativo. O conector de nuvem GIS fornece um subconjunto da extensa e poderosa API REST que permite que as automações conduzam a maioria dos casos de uso comuns para um projeto do Mapa. Esse conector permitirá que você liste, atualize e interopere gis mapas de nuvem, camadas, usuários e também crie recursos e arquivos. Com esse subconjunto, um usuário pode automatizar muitas atividades controladas por dados, como criar novos recursos para inspeção, criar relatórios, exportar dados para dashboards etc...
Pré-requisitos
Para usar o conector do GIS Cloud, você deve ter uma conta de usuário do GIS Cloud com uma assinatura do Editor de Mapa, caso contrário, muitas Ações não funcionarão.
Como obter credenciais
A API REST da Nuvem do GIS é protegida por meio de uma chave de API. A maioria dos pontos de extremidade REST não funcionará sem uma chave de API válida.
Para obter uma chave de API válida, navegue até https://manager.giscloud.com e faça logon com sua conta do GIS Cloud.
No canto superior direito, clique no nome de usuário e selecione "Minha Conta" no menu suspenso.
No modal pop-up, selecione a guia "Acesso à API". Insira um nome descritivo para a chave na caixa "Nova descrição da chave de API" e clique em "Adicionar chave". Um novo modal apresentará sua nova Chave de API que você deve copiar e armazenar com segurança, pois ela nunca mais será mostrada.
Para obter referência adicional, consulte: https://docs.giscloud.com/rest#creating-an-api-key
Depois que isso for concluído, você poderá criar e testar o conector.
Introdução ao conector
Ao configurar o conector pela primeira vez, o teste por meio da ação GetCurrentUser confirmará que sua chave de API é válida e retornará os detalhes da conta associados à chave de API.
A maioria dos usuários utilizará as ações GetFeatures, CreateFeature, UpdateFeature e DeleteFeature em suas automações. As outras ações incluídas serão usadas principalmente para a coordenação específica da situação de um determinado cenário de automação.
Um cenário típico de automação é sincronizar os recursos do GIS Cloud do banco de dados SaaS em uma tabela do Dataverse ou planilha do Excel com a finalidade de criar um painel do Power BI. Dependendo da estrutura de dados, talvez seja necessário criar entidades personalizadas do Dataverse. É recomendável que uma automação aproveite o where parâmetro na ação GetFeatures para limitar os recursos modificados nos últimos dias e apenas sincronizá-los. Isso otimizará o desempenho da automação.
Outro cenário típico de automação é criar novos recursos de nuvem gis automaticamente com base em uma fonte de dados secundária, como Dynamics, SalesForce, solicitações HTTP ou até mesmo gis cloud propriamente dita. Para isso, é recomendável que os usuários considerem cuidadosamente como filtrar sua fonte de dados secundária para disparar a criação do recurso e finalizarem o esquema de camada de destino do GIS Cloud antes de criar a automação, pois isso simplificará o desenvolvimento.
Um cenário de automação típico final é "arquivar" automaticamente os recursos do GIS Cloud copiando aqueles que atendem a determinados critérios (ou seja, um conjunto de status específico em uma coluna) para outra Camada e, em seguida, ao excluir com êxito o recurso de nuvem gis original. Isso permite que um projeto de Mapa ativo seja mantido visualmente limpo sem perda de dados críticos.
Problemas e limitações conhecidos
Compatibilidade de autenticação para PowerApps
Para auxiliar a compatibilidade com o componente de mapa do PCF publicado pelo HandyGeo Services e evitar solicitar aos usuários do PowerApps chaves de API que não sejam amigáveis, criamos o conector para exigir que a chave de API seja especificada a cada solicitação.
Esquema de dados dinâmicos para pontos de extremidade de recurso
Devido aos recursos geográficos no GIS Cloud originários de dados carregados pelo usuário, o esquema é sempre específico do conjunto de dados. Como tal, o esquema para conteúdos e respostas de todos os pontos de extremidade de recurso são sempre dinâmicos e exigem suporte para esquemas dinâmicos no produto do Office 365 que está sendo usado. Isso geralmente é bem suportado pelo PowerAutomate, mas pode apresentar desafios no PowerApps.
Erros e soluções comuns
Paginação de ponto de extremidade
Os pontos de extremidade de nuvem gis são limitados a um máximo de 5.000 registros sendo retornados de uma única solicitação. Embora a API REST dê suporte à paginação, atualmente não há como incluir isso automaticamente no comportamento do conector.
Limitação de taxa de API REST para proteção de serviço
Como deve ser esperado com qualquer serviço de API REST de produção, se um número excessivo de solicitações para a API de Nuvem do GIS for feito em um curto período de tempo, a resposta será um código 5xx. Embora um limite de taxa específico não seja definido explicitamente, a API REST dará suporte a uma taxa de loop paralela limitada (ou seja, aproximadamente 20), mas as altas taxas provavelmente resultarão em falhas significativas. As respostas com falha podem ser gerenciadas com uma política de repetição, mas taxas excessivas causarão problemas.
Esquema de dados de recurso dinâmico ausente
Devido ao conector que precisa pesquisar a definição de esquema, se a ID da camada e/ou os parâmetros de chave de API forem passados dinamicamente, a Ação não poderá armazenar em cache o esquema de camadas, o que exigirá que os usuários gerenciem manualmente o JSON retornado. Substitua o parâmetro dinâmico por um valor estático digitando-o na caixa de parâmetros e o esquema será devidamente armazenado em cache.
perguntas frequentes
A Ação GetFeatures retorna muitos recursos, como posso obter apenas os que quero?
É recomendável sempre que possível que os usuários aproveitem a where cláusula disponível na ação GetFeatures. Isso pode acomodar a maioria das cláusulas em conformidade com WHERE SQL. Para campos como a data modificada do registro gerenciado pela plataforma, é recomendável que os usuários testem na ação GetColumns para exibir o nome lógico verdadeiro das colunas do sistema.
Como fazer para carregar um arquivo no armazenamento de proprietários do projeto mapa, não no meu próprio armazenamento?
Para a ação, UploadFileToPath, é essencial que, se a chave de API não for para a conta de proprietários do projeto mapa, o Destination Map ID (destination_map) parâmetro seja preenchido. Isso sinaliza para a API REST da Nuvem gis que o arquivo carregado não é para o usuário autenticado, mas para o proprietário do projeto map especificado. Se o usuário não tiver permissões para acessar o Mapa, o upload não será roteado para a conta do map oweners.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar um mapa |
Atualizar um projeto de mapa de nuvem do GIS |
| Atualizar uma camada |
Atualize um objeto gis cloud layer. |
| Carregar um arquivo |
Carrega um arquivo no armazenamento em nuvem do GIS. |
| Criar um novo recurso em uma camada |
Obtenha todos os objetos de recurso de nuvem do GIS em um objeto Layer. |
| Excluir Cache de Mapa |
Exclui o cache de blocos do mapa para refletir as alterações feitas por meio da API. |
| Excluir recurso |
Exclui o objeto de recurso gis cloud especificado da camada. |
| Excluir um mapa |
Excluir um projeto de mapa de nuvem do GIS |
| Excluir uma camada |
Exclua um objeto gis cloud layer. |
| Obter colunas para camada |
Obter uma lista de colunas para uma camada |
| Obter objeto de usuário atual |
Obtenha o objeto de usuário atual do GIS Cloud. |
| Obter objeto de usuário por ID |
Obtenha o Objeto de Usuário da Nuvem do GIS pela ID do usuário. |
| Obter recurso |
Obtenha um objeto de recurso de nuvem GIS em um objeto Layer. |
| Obter recursos em uma camada |
Obtenha todos os objetos de recurso de nuvem do GIS em um objeto Layer. |
| Obter todas as camadas |
Obtenha todos os objetos de camada de nuvem do GIS. |
| Obter todas as camadas em um mapa |
Obtenha todos os Objetos de Camada para um único objeto de mapa de nuvem do GIS. |
| Obter todos os Mapas |
Obtenha todos os objetos de mapa de nuvem do GIS. |
| Obter um arquivo |
Baixe um arquivo do armazenamento em nuvem do GIS. |
| Obter um mapa |
Obtenha um objeto de mapa de nuvem do GIS. |
| Obter uma camada |
Obtenha todo o objeto GIS Cloud Layer. |
| Obter uma mídia arquivada do campo Recurso |
Obtenha um arquivo de mídia de um campo objeto de recurso de nuvem GIS em um objeto layer. |
| Recurso atualizar |
Atualize um objeto de recurso de nuvem GIS em um objeto Layer. |
| Remover um arquivo |
Remove um arquivo no armazenamento em nuvem do GIS. |
| Renderizar um mapa |
Renderizar imagem de um objeto de mapa de nuvem do GIS. |
Atualizar um mapa
Atualizar um projeto de mapa de nuvem do GIS
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
|
Nome
|
name | string |
Nome do Mapa |
Atualizar uma camada
Atualize um objeto gis cloud layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
Nome
|
name | string |
Nome da camada |
Carregar um arquivo
Carrega um arquivo no armazenamento em nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Dados do arquivo
|
filedata | True | file |
O arquivo a ser carregado. |
|
ID do Mapa de Destino
|
destination_map | integer |
A ID do mapa compartilhado. Se definido, carrega o arquivo para mapear o armazenamento de proprietários. |
|
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
local
|
location | string |
Criar um novo recurso em uma camada
Obtenha todos os objetos de recurso de nuvem do GIS em um objeto Layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
conteúdo
|
payload | dynamic |
Para criar um novo recurso, qualquer coisa deixada em branco será criada como nula. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
local
|
location | string |
Excluir Cache de Mapa
Exclui o cache de blocos do mapa para refletir as alterações feitas por meio da API.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
|
Reinicializar gatilho
|
init_trigger | True | integer |
Se o mapa for reinicializado antes de executar a operação |
|
Lista de Camadas
|
layers | string |
Lista CSV de IDs de camada a serem incluídas |
Excluir recurso
Exclui o objeto de recurso gis cloud especificado da camada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
A ID de recurso interna usada para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
Excluir um mapa
Excluir um projeto de mapa de nuvem do GIS
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
Excluir uma camada
Exclua um objeto gis cloud layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
Obter colunas para camada
Obter uma lista de colunas para uma camada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
Obter objeto de usuário atual
Obtenha o objeto de usuário atual do GIS Cloud.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
Retornos
- Corpo
- User
Obter objeto de usuário por ID
Obtenha o Objeto de Usuário da Nuvem do GIS pela ID do usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Identificação de usuário
|
user_id | True | integer |
A ID de Usuário interna usada para identificar um usuário específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
Retornos
- Corpo
- User
Obter recurso
Obtenha um objeto de recurso de nuvem GIS em um objeto Layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
A ID de recurso interna usada para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
Incluir Geometria
|
geometry | string |
Formato no qual a geometria será empacotada. Valores possíveis: 'wkt', 'kml' e 'gml' |
|
|
Projeção de EPSG
|
epsg | integer |
Código EPSG para a projeção de saída. se a projeção de mapa padrão não especificada for usada |
Retornos
Obter recursos em uma camada
Obtenha todos os objetos de recurso de nuvem do GIS em um objeto Layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
Incluir Geometria
|
geometry | string |
Formato no qual a geometria será empacotada. Valores possíveis: 'wkt', 'kml' e 'gml' |
|
|
Projeção de EPSG
|
epsg | integer |
Código EPSG para a projeção de saída. se a projeção de mapa padrão não especificada for usada |
|
|
Limites espaciais
|
bounds | string |
Caixa delimitadora usada para filtragem espacial |
|
|
SQL Onde
|
where | string |
Tipo SQL em que a cláusula, usada para filtragem de atributos |
|
|
Ordenar por
|
order_by | string |
Isso deve fazer referência a colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada como Acending, mas incluir :d esc inverte a ordem. Order by, format "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a ser exibido (Padrão: 100, Máximo: 5000) |
|
|
Página Não
|
page | integer |
Número da página para a resposta |
|
|
Sem Total
|
nototal | integer |
O total de resultados não é contado e exibido; melhora o tempo de resposta; usado para obter a resposta mais rapidamente |
Retornos
Obter todas as camadas
Obtenha todos os objetos de camada de nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
|
|
Tipo de visibilidade
|
type | string |
Filtrar por visibilidade: 'público', 'privado', 'compartilhado' ou 'privado', compartilhado |
|
|
Ordenar por
|
order_by | string |
Isso deve fazer referência a colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada como Acending, mas incluir :d esc inverte a ordem. Order by, format "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a ser exibido (Padrão: 100, Máximo: 5000) |
|
|
Página Não
|
page | integer |
Número da página para a resposta |
|
|
Sem Total
|
nototal | True | integer |
O total de resultados não é contado e exibido; melhora o tempo de resposta; usado para obter a resposta mais rapidamente |
Retornos
- Corpo
- Layers
Obter todas as camadas em um mapa
Obtenha todos os Objetos de Camada para um único objeto de mapa de nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
|
|
Ordenar por
|
order_by | string |
Isso deve fazer referência a colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada como Acending, mas incluir :d esc inverte a ordem. Order by, format "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a ser exibido (Padrão: 100, Máximo: 5000) |
|
|
Página Não
|
page | integer |
Número da página para a resposta |
|
|
Sem Total
|
nototal | integer |
O total de resultados não é contado e exibido; melhora o tempo de resposta; usado para obter a resposta mais rapidamente |
Retornos
- Corpo
- Layers
Obter todos os Mapas
Obtenha todos os objetos de mapa de nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Tipo de visibilidade
|
type | string |
Filtrar por visibilidade: 'público', 'privado', 'compartilhado' ou 'privado', compartilhado |
|
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
|
|
Ordenar por
|
order_by | string |
Isso deve fazer referência a colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada como Acending, mas incluir :d esc inverte a ordem. Order by, format "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a ser exibido (Padrão: 100, Máximo: 5000) |
|
|
Página Não
|
page | integer |
Número da página para a resposta |
|
|
Sem Total
|
nototal | integer |
O total de resultados não é contado e exibido; melhora o tempo de resposta; usado para obter a resposta mais rapidamente |
Retornos
- Corpo
- Maps
Obter um arquivo
Baixe um arquivo do armazenamento em nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
|
Nome do Arquivo
|
file_name | True | string |
Nome de um arquivo de mídia específico hosed no armazenamento SaaS |
Retornos
- response
- file
Obter um mapa
Obtenha um objeto de mapa de nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
Retornos
- Corpo
- Map
Obter uma camada
Obtenha todo o objeto GIS Cloud Layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções de Enum |
Retornos
- Corpo
- Layer
Obter uma mídia arquivada do campo Recurso
Obtenha um arquivo de mídia de um campo objeto de recurso de nuvem GIS em um objeto layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Baixar Arquivo
|
download | boolean |
Se um arquivo de mídia recuperado for baixado diretamente |
|
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
|
Nome do campo
|
field_name | True | string |
Nome de um campo de recurso em uma determinada camada |
|
ID do recurso
|
feature_id | True | integer |
A ID de recurso interna usada para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
Retornos
- response
- file
Recurso atualizar
Atualize um objeto de recurso de nuvem GIS em um objeto Layer.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
A ID de recurso interna usada para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
A ID de camada interna usada para identificar uma camada específica |
|
conteúdo
|
payload | dynamic |
Os novos dados de recurso a serem atualizados |
Remover um arquivo
Remove um arquivo no armazenamento em nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
Nome do Arquivo
|
file_name | True | string |
Nome de um arquivo de mídia específico hosed no armazenamento SaaS |
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
Renderizar um mapa
Renderizar imagem de um objeto de mapa de nuvem do GIS.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API de Nuvem do GIS usada para autorizar a operação |
|
ID do mapa
|
map_id | True | integer |
A ID interna do Mapa usada para identificar um mapa específico |
|
Largura da imagem
|
width | number |
Largura da imagem em pixels |
|
|
Altura da imagem
|
height | number |
Altura da imagem em pixels |
|
|
Invalidar Cache
|
invalidate | number |
Invalidar cache |
|
|
Mostrar Lista de Camadas
|
layerlist | number |
Definir a lista de camadas como visível na imagem |
|
|
Imagem salva
|
justgenerate | number |
Basta gerar a imagem sem salvar |
Retornos
- response
- file
Definições
Mapas
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de registros
|
total | integer |
Contagem total de registros que podem ser recuperados |
|
Página Atual
|
page | integer |
O número da página retornada |
|
Objetos de mapa
|
data | array of Map |
Matriz de objetos de mapa retornados |
Map
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do mapa
|
id | integer |
ID interna deste mapa |
|
Nome
|
name | string |
Nome do Mapa |
|
Objeto Owner
|
owner | array of string |
Objeto de proprietário do mapa. Esse valor será exibido somente se o parâmetro de expansão contiver a chave 'owner' |
|
Active
|
active | string |
O mapa está ativo |
|
Direitos autorais
|
copyright | string |
Cadeia de caracteres de instrução copyright |
|
Proj4
|
proj4 | string |
Projeção de mapa proj4 |
|
Unidades Proj4
|
units_proj4 | string |
Unidades da definição proj4 |
|
Código EPSG
|
epsg | string |
Código de projeção de mapa EPSG |
|
Unidades de mapa
|
units | string |
Unidades de mapa (medidor, pé ou foot_us) |
|
Zoom Máximo
|
maxzoom | string |
Zoom máximo |
|
Cor da tela de fundo
|
bgcolor | string |
Cor do plano de fundo do mapa |
|
Modificado em
|
modified | integer |
Mapa da última vez modificado (carimbo de data/hora UNIX) |
|
Acessado em
|
accessed | integer |
Última vez que o mapa foi acessado (carimbo de data/hora UNIX) |
|
Criado em
|
created | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Contagem de modos de exibição
|
visited | string |
Número de exibições de mapa |
|
Arquivados
|
archived | string |
O mapa é arquivado |
|
ID de Recurso
|
resource_id | string |
resource_id |
|
Unidade de Medida
|
measure_unit | string |
measure_unit |
|
Visível
|
visible | string |
visível |
|
Objeto Resource
|
resource | Resource |
Mapear objeto de recurso |
|
Description
|
description | string |
Descrição do mapa |
|
mobileacess
|
mobileacess | string |
mobileacess |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
maptype
|
maptype | string |
maptype |
|
assets
|
assets | string |
assets |
|
classificação
|
rating | string |
classificação |
|
compartilhamento
|
share | string |
compartilhamento |
|
Limites xMin
|
bounds.xmin | float |
xmin |
|
Limites xMax
|
bounds.xmax | float |
xmax |
|
Limites yMin
|
bounds.ymin | float |
ymin |
|
Limites yMax
|
bounds.ymax | float |
ymax |
|
limitado
|
bound | string |
limitado |
Resource
Mapear objeto de recurso
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de Recurso
|
id | integer |
ID interna deste recurso |
|
Tipo de recurso
|
type | string |
Tipo enumerado de Recurso |
|
Local do recurso
|
location | string |
TBC com valores potencialmente nulos |
|
ID de Recurso
|
target_resource_id | string |
resource_id |
|
ID do Proprietário do Recurso
|
owner_id | string |
ID de usuário do usuário que possui este recurso |
|
ID pai do recurso
|
parent_id | string |
TBC com valores potencialmente nulos |
|
ID da assinatura de pagamento de recursos
|
payment_subscription_id | string |
TBC com valores potencialmente nulos |
|
ID de pagamento de recurso
|
payment_id | string |
TBC com valores potencialmente nulos |
|
Obs de ID de Pagamento de Recurso
|
payment_id_obs | string |
TBC com valores potencialmente nulos |
|
Recurso arquivado
|
archived | string |
Indica se o recurso foi arquivado |
|
Recurso desabilitado
|
disabled | string |
TBC com valores potencialmente nulos |
|
Tempo de Acesso ao Recurso
|
access_time | object |
Recurso de hora foi acessado pela última vez |
|
Modificado em
|
modified | integer |
Última vez que o recurso foi modificado (carimbo de data/hora UNIX) |
|
Criado em
|
created | integer |
Hora em que o recurso foi criado (carimbo de data/hora UNIX) |
Camadas
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de registros
|
total | integer |
Contagem total de registros que podem ser recuperados |
|
Página Atual
|
page | integer |
O número da página retornada |
|
Objetos de camada
|
data | array of Layer |
Matriz de objetos de camada retornados |
Camada
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da camada
|
id | integer |
A ID interna da camada |
|
Nome da camada
|
name | string |
Nome da camada definida pelo usuário |
|
Objeto Owner
|
owner | array of string |
Objeto proprietário da camada, EXPANDABLE |
|
Tipo de origem de camada
|
source.type | string |
Tipo de dados fornecidos |
|
URI de origem da camada
|
source.src | string |
Cadeia de caracteres de URI definindo onde os dados estão |
|
OnScale
|
onscale | string |
Definir escala em qual camada está visível |
|
OffScale
|
offscale | string |
Definir escala em qual camada está oculta |
|
Rótulo de camada
|
label | string |
Nome do atributo da fonte de dados a ser usada para um rótulo de linha |
|
x Min
|
x_min | string |
Coordenada mínima X associada à camada |
|
x Max
|
x_max | string |
Coordenada máxima X associada à camada |
|
y Min
|
y_min | string |
Coordenada mínima Y associada à camada |
|
y Max
|
y_max | string |
Coordenada máxima Y associada à camada |
|
Campo Texto da Camada
|
textfield | string |
Nome do atributo da fonte de dados a ser usada como um campo de texto |
|
Modificado em
|
modified | integer |
Mapa da última vez modificado (carimbo de data/hora UNIX) |
|
Criado em
|
created | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Estilos de camada
|
styles | string |
Objeto de estilo de camada complexo para estilo de camada |
|
Camada Alfa
|
alpha | string |
Transparência da camada |
|
Codificação de fonte de dados de camada
|
encoding | string |
Codificação de fonte de dados de camada |
|
Margem de Texto de Camada
|
margin | string |
Margem de campo de texto |
|
Visibilidade da camada
|
visible | string |
Controla a visibilidade da camada, 't' ou 'f' |
|
Camada bloqueada
|
lock | string |
Controla a interatividade da camada, 't' ou 'f' |
|
Camada de raster
|
raster | string |
A camada é uma fonte de dados do Raster, 't' ou 'f' |
|
Camada exportável
|
exportable | string |
Definir se a camada pode ser exportada, 't' ou 'f' |
|
Camada mesclada
|
merged | string |
A camada é mesclada |
|
Pasta Pai da Camada
|
parent | string |
ID da camada de pasta pai |
|
Dica de ferramenta de camada
|
tooltip | string |
Dica de ferramenta que aparece no mouse sobre os recursos de camada |
|
Ocultar Geometria
|
hidegeometry | string |
Ocultar geometria de camada. Pode ser útil se quisermos mostrar apenas rótulos, 't' ou 'f' |
|
Usar pop-up de informações
|
use_info_window | string |
Mostrar informações de recursos de camada em um pop-up de mapa, 't' ou 'f' |
|
ID da Fonte de Dados da Camada
|
datasource_id | string |
ID da fonte de dados da camada |
|
EPSG de camada
|
epsg | string |
Código EPSG de fonte de dados |
|
Camada Aberta
|
opened | string |
Para o valor booliano de abertura/fechamento da camada de pasta, 't' ou 'f' |
|
ID do recurso de camada
|
resource_id | string |
ID do recurso da camada |
|
ID do Mapa de Camadas
|
map_id | string |
ID do mapa à qual a camada pertence |
|
Tipo de geom de camada
|
type | string |
Tipo de geometria de camada. Os valores possíveis são 'point', 'line', 'polygon', 'tile' e 'wms'. |
|
Ordem da camada
|
order | integer |
Índice de Camada Z |
|
Objeto Opções de Camada
|
options | object |
Lista de opções vinculadas a esse recurso. Esse valor só será exibido se o parâmetro de expansão contiver a chave 'options' |
|
Nome do Formulário
|
form.name | string |
Nome definido pelo usuário do formulário anexado |
|
Definição de formulário de camada
|
form.definition | string |
Definição do formulário anexado à camada |
|
ID do recurso de fonte de dados
|
datasource.resource_id | string |
ID do recurso da fonte de dados |
|
Tipo de fonte de dados
|
datasource.type | string |
Tipo de fonte de dados para a camada |
|
ID do proprietário da fonte de dados
|
datasource.owner_id | string |
owner_id |
|
permissões
|
datasource.permissions | array of string |
nome |
|
Esquema de coluna de camada
|
columns | object |
Mostrar colunas de fonte de dados de camada, EXPANDABLE |
|
subcaminhos
|
sublayers | array of Layer |
Matriz de objetos layer aninhados nessa camada |
Utilizador
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificação de usuário
|
id | integer |
ID de usuário exclusiva |
|
Tipo de usuário
|
type | string |
Tipo de usuário especificado |
|
Usuário Ativo
|
active | string |
O usuário está ativo, 't' ou 'f' |
|
Nome de usuário
|
username | string |
Nome de usuário dos usuários |
|
Nome do usuário
|
firstname | string |
Nome dos usuários |
|
Sobrenome do Usuário
|
lastname | string |
Sobrenome dos usuários |
|
ID do Proprietário do Usuário
|
owner_id | string |
ID de usuário do usuário proprietário deste usuário |
|
Telefone do Usuário
|
phone | string |
Número de Telefone dos Usuários |
|
User Mobile
|
mobile | string |
Número do Celular dos Usuários |
|
Criado em
|
created | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Último Logon
|
lastlog | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Empresa de Usuários
|
company | string |
Nome da Empresa de Usuários |
|
URL da Web do usuário
|
web | string |
Site de Perfil de Usuário |
|
Email do Usuário
|
string |
Endereço de email dos usuários |
|
|
Avatar do Usuário
|
avatar | string |
URL para recuperar o avatar dos usuários |
|
Idioma do Usuário
|
language | string |
Idioma selecionado pelos usuários |
|
Contagem de recursos de arquivo
|
file_feature_count | string |
Contagem de recursos geográficos no sistema de arquivos |
|
Contagem de recursos do BD
|
db_feature_count | string |
Contagem de recursos geográficos no banco de dados |
|
Raster de usuário armazenado
|
storage_raster | string |
Armazenamento de arquivos consumido por blocos raster |
|
Capcity de Armazenamento do Usuário
|
storage_total | string |
Total de armazenamento de arquivos consumido |
|
Limite de recursos do usuário
|
feature_count_limit | string |
Contagem máxima de recursos licenciados |
|
Limite de Raster do Usuário
|
storage_raster_limit | string |
Capacidade máxima de armazenamento licenciada |
|
Início da assinatura
|
subscription_begins | string |
Quando a assinatura de usuários começa |
|
A assinatura expira
|
subscription_expires | string |
Quando a assinatura dos usuários terminar |
|
ID do recurso do usuário
|
resource_id | string |
ID de recurso interno para este usuário |
|
Última modificação do usuário
|
modified | integer |
Hora da data da última modificação (formato UNIX) |
|
Organização de Usuários
|
organization_id | string |
ID da organização para este usuário |
|
OIDC do usuário
|
oidc | string |
OpenID Connect |
|
Opções de Usuário
|
options | string |
Lista de opções vinculadas ao usuário. Esse valor só será exibido se o parâmetro 'expand' contiver a chave 'options' |
|
consentimentos
|
consents | array of object |
Objeto de contratos de consentimento do usuário |
|
Finalidade de consentimento
|
consents.purpose | string |
A finalidade do consentimento solicitado |
|
Versão de consentimento
|
consents.version | string |
A versão do consentimento concedido |
|
Consentimento Acordado
|
consents.agreed | string |
Foi concedido o consentimento |
arquivo
Esse é o tipo de dados básico 'file'.