GIS Cloud (Pré-visualização)
Este 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 recurso de uma determinada camada.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte GIS Cloud Premium |
| URL | https://docs.giscloud.com/rest |
| premiumsupport@giscloud.com |
| Metadados do conector | |
|---|---|
| Editora | Soluções HandyGeo |
| Sítio Web | http://www.giscloud.com |
| Política de privacidade | https://www.giscloud.com/privacy-policy/ |
| Categorias | Dados; Inteligência de Negócios |
O GIS Cloud é uma plataforma SaaS que fornece a melhor renderização de mapas web e móveis da categoria, juntamente com um poderoso mecanismo de formulários para facilitar todas as suas necessidades de mapeamento colaborativo. O conector GIS Cloud 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 de mapa. Este conector irá aloow para listar, atualizar e interogate GIS Cloud Maps, camadas, usuários e também para criar recursos e arquivos. Com este subconjunto, um usuário pode automatizar muitas atividades orientadas por dados, como a criação de novos recursos para inspeção, criação de relatórios, exportação de dados para dashboards, etc...
Pré-requisitos
Para utilizar o conector GIS Cloud, tem de ter uma conta de utilizador GIS Cloud com uma subscrição do Map Editor, caso contrário muitas Ações não funcionarão.
Como obter credenciais
A API GIS Cloud REST é protegida através de uma chave API. A maioria dos pontos de extremidade REST não funcionará sem uma chave de API válida.
Para obter uma chave API válida, navegue e https://manager.giscloud.com inicie sessão com a sua conta GIS Cloud.
No canto superior direito, clique no seu nome de usuário e selecione "Minha conta" no menu suspenso.
No modal pop-up, selecione a guia "API Access". Digite um nome descritivo para a chave na caixa "Nova descrição da chave da 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 nunca mais será mostrada.
Para mais informações, consultar: https://docs.giscloud.com/rest#creating-an-api-key
Depois disso, você pode 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á se 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 de uma situação de um determinado cenário de automação.
Um cenário de automação típico é sincronizar recursos do GIS Cloud do banco de dados SaaS em uma tabela Dataverse ou planilha do Excel para fins de criação de um painel do Power BI. Dependendo da sua estrutura de dados, pode ser necessário criar entidades Dataverse personalizadas. Recomenda-se que uma automação aproveite o where parâmetro na ação GetFeatures para limitar aos recursos modificados nos últimos dias e sincronizá-los apenas. Isso otimizará o desempenho da sua automação.
Outro cenário típico de automação é criar novos recursos do GIS Cloud automaticamente com base em uma fonte de dados secundária, como Dynamics, SalesForce, solicitações HTTP ou até mesmo o próprio GIS Cloud. Para conseguir isso, recomenda-se que os usuários considerem cuidadosamente como filtrar sua fonte de dados secundária para acionar a criação do recurso e tenham finalizado seu esquema de camada de destino do GIS Cloud antes de criar a automação, pois isso simplificará o desenvolvimento.
Um último cenário típico de automação é "arquivar" automaticamente os recursos do GIS Cloud copiando aqueles que atendem a certos critérios (ou seja, um status específico definido em uma coluna) para outra camada e, em seguida, excluindo com sucesso o recurso original do GIS Cloud. Isso permite que um projeto de mapa ativo seja mantido visualmente limpo sem qualquer perda de dados críticos.
Problemas conhecidos e limitações
Compatibilidade de autenticação para PowerApps
Para ajudar na compatibilidade com o componente de mapa PCF publicado pelo HandyGeo Services e evitar solicitar aos usuários do PowerApps chaves de API que não são fáceis de usar, criamos o conector para exigir que a chave de API seja especificada com cada solicitação.
Esquema de dados dinâmicos para pontos de extremidade de recurso
Devido a características geográficas no GIS Cloud originadas de dados carregados pelo usuário, o esquema é sempre específico do conjunto de dados. Como tal, o esquema para cargas úteis e respostas de todos os pontos de extremidade de recurso são sempre dinâmicos e exigem suporte para esquemas dinâmicos no produto Office 365 que está sendo usado. Isso geralmente é bem suportado pelo PowerAutomatic, mas pode apresentar desafios no PowerApps.
Erros e soluções comuns
Paginação do ponto final
Os endpoints do GIS Cloud são limitados a um máximo de 5.000 registros retornados de uma única solicitação. Embora a API REST ofereça suporte à paginação, atualmente não há como incluir isso automaticamente no comportamento do conector.
Limitação da 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 do GIS Cloud 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 explicitamente definido, a API REST suportará uma taxa de loop paralelo limitada (ou seja, aproximadamente 20), mas taxas altas provavelmente resultarão em falhas significativas. As respostas com falha podem ser gerenciadas com uma política de novas tentativas, mas taxas excessivas causarão problemas.
Esquema de dados do recurso dinâmico ausente
Devido à necessidade do conector pesquisar a definição de esquema, se os parâmetros de ID de camada e/ou 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á armazenado em cache adequadamente.
FAQ
A ação GetFeatures retorna muitos recursos, como posso obter apenas os que eu quero?
Recomenda-se, 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 compatíveis com WHERE SQL. Para campos como a data de modificação do registro gerenciada pela plataforma, é recomendável que os usuários testem a ação GetColumns para exibir o verdadeiro nome lógico das colunas do sistema.
Como carrego um ficheiro para o armazenamento de proprietários de projetos do Mapa, não para o meu próprio armazenamento?
Para a ação, UploadFileToPath, é essencial que, se a chave da API não for para a conta Map project owners, o Destination Map ID (destination_map) parâmetro seja preenchido. Isso sinaliza para a API REST do GIS Cloud 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 oweners do mapa.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar um mapa |
Atualizar um projeto SIG Cloud Map |
| Atualizar uma camada |
Atualize um objeto GIS Cloud Layer. |
| Carregar um ficheiro |
Carrega um ficheiro para o armazenamento GIS Cloud. |
| Criar novo recurso em uma camada |
Obtenha todos os objetos de recursos do GIS Cloud em um objeto de camada. |
| 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 |
Eliminar um projeto SIG Cloud Map |
| Excluir uma camada |
Exclua um objeto de camada de nuvem GIS. |
| Obter colunas para camada |
Obter uma lista de colunas para uma camada |
| Obter objeto de usuário atual |
Obtenha o GIS Cloud User Object atual. |
| Obter objeto de usuário por ID |
Obtenha o GIS Cloud User Object pelo ID do usuário. |
| Obter recurso |
Obtenha um objeto de recurso do GIS Cloud em um objeto de camada. |
| Obter recursos em uma camada |
Obtenha todos os objetos de recursos do GIS Cloud em um objeto de camada. |
| Obter todas as camadas |
Obtenha todos os objetos GIS Cloud Layer. |
| Obter todas as camadas em um mapa |
Obtenha todos os objetos de camada para um único objeto GIS Cloud Map. |
| Obter todos os mapas |
Obtenha todos os objetos do GIS Cloud Map. |
| Obter um ficheiro |
Transfira um ficheiro a partir do armazenamento GIS Cloud. |
| Obter um mapa |
Obtenha um objeto GIS Cloud Map. |
| Obter uma camada |
Obtenha todo o GIS Cloud Layer Object. |
| Obter uma mídia arquivada no campo Recurso |
Obtenha um arquivo de mídia de um campo GIS Cloud Feature Object em um objeto de camada. |
| Recurso de atualização |
Atualize um objeto de recurso do GIS Cloud em um objeto de camada. |
| Remover um ficheiro |
Remove um ficheiro no armazenamento GIS Cloud. |
| Renderizar um mapa |
Renderize a imagem de um objeto GIS Cloud Map. |
Atualizar um mapa
Atualizar um projeto SIG Cloud Map
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado para identificar um mapa específico |
|
Nome
|
name | string |
Nome do Mapa |
Atualizar uma camada
Atualize um objeto GIS Cloud Layer.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
Nome
|
name | string |
Nome da camada |
Carregar um ficheiro
Carrega um ficheiro para o armazenamento GIS Cloud.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Dados de arquivo
|
filedata | True | file |
O ficheiro a carregar. |
|
ID do Mapa de Destino
|
destination_map | integer |
O ID do mapa compartilhado. Se definido, carrega o arquivo para mapear o armazenamento dos proprietários. |
|
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
localização
|
location | string |
Criar novo recurso em uma camada
Obtenha todos os objetos de recursos do GIS Cloud em um objeto de camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
payload
|
payload | dynamic |
Os dados a partir dos quais criar um novo recurso, qualquer coisa deixada em branco será criada como nula. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
localização
|
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado 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 incluir |
Excluir recurso
Exclui o objeto de recurso GIS Cloud especificado da camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
O ID de recurso interno usado para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
Excluir um mapa
Eliminar um projeto SIG Cloud Map
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado para identificar um mapa específico |
Excluir uma camada
Exclua um objeto de camada de nuvem GIS.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
Obter colunas para camada
Obter uma lista de colunas para uma camada
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
Obter objeto de usuário atual
Obtenha o GIS Cloud User Object atual.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
Devoluções
- Body
- User
Obter objeto de usuário por ID
Obtenha o GIS Cloud User Object pelo ID do usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID de Utilizador
|
user_id | True | integer |
O ID de usuário interno usado para identificar um usuário específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
Devoluções
- Body
- User
Obter recurso
Obtenha um objeto de recurso do GIS Cloud em um objeto de camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
O ID de recurso interno usado para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
Incluir Geometria
|
geometry | string |
Formato em que a geometria será embalada. Valores possíveis: 'wkt', 'kml' e 'gml' |
|
|
Projeção EPSG
|
epsg | integer |
Código EPSG para a projeção de saída. Se não for especificado, a projeção de mapa padrão é usada |
Devoluções
Obter recursos em uma camada
Obtenha todos os objetos de recursos do GIS Cloud em um objeto de camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
Incluir Geometria
|
geometry | string |
Formato em que a geometria será embalada. Valores possíveis: 'wkt', 'kml' e 'gml' |
|
|
Projeção EPSG
|
epsg | integer |
Código EPSG para a projeção de saída. Se não for especificado, a projeção de mapa padrão é usada |
|
|
Limites espaciais
|
bounds | string |
Caixa delimitadora usada para filtragem espacial |
|
|
SQL Onde
|
where | string |
Cláusula where do tipo SQL, usada para filtragem de atributos |
|
|
Encomendar por
|
order_by | string |
Isso deve fazer referência às colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada Anexando, mas incluindo :d esc inverte a ordem. Ordenar por, formato "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a apresentar (Padrão: 100, Máximo: 5000) |
|
|
N.º da página
|
page | integer |
Número da página da 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 |
Devoluções
Obter todas as camadas
Obtenha todos os objetos GIS Cloud Layer.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
|
|
Tipo de visibilidade
|
type | string |
Filtrar por visibilidade: 'público', 'privado', 'partilhado' ou 'privado,partilhado' |
|
|
Encomendar por
|
order_by | string |
Isso deve fazer referência às colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada Anexando, mas incluindo :d esc inverte a ordem. Ordenar por, formato "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a apresentar (Padrão: 100, Máximo: 5000) |
|
|
N.º da página
|
page | integer |
Número da página da 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 |
Devoluções
- Body
- Layers
Obter todas as camadas em um mapa
Obtenha todos os objetos de camada para um único objeto GIS Cloud Map.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado para identificar um mapa específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
|
|
Encomendar por
|
order_by | string |
Isso deve fazer referência às colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada Anexando, mas incluindo :d esc inverte a ordem. Ordenar por, formato "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a apresentar (Padrão: 100, Máximo: 5000) |
|
|
N.º da página
|
page | integer |
Número da página da 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 |
Devoluções
- Body
- Layers
Obter todos os mapas
Obtenha todos os objetos do GIS Cloud Map.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Tipo de visibilidade
|
type | string |
Filtrar por visibilidade: 'público', 'privado', 'partilhado' ou 'privado,partilhado' |
|
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
|
|
Encomendar por
|
order_by | string |
Isso deve fazer referência às colunas que existem no objeto GIS Cloud de destino. Por padrão, a coluna é classificada Anexando, mas incluindo :d esc inverte a ordem. Ordenar por, formato "{created|modified|created}:[asc|desc]" Por exemplo, order_by=accessed:desc |
|
|
Itens Per-Page
|
perpage | integer |
Número de resultados por página a apresentar (Padrão: 100, Máximo: 5000) |
|
|
N.º da página
|
page | integer |
Número da página da 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 |
Devoluções
- Body
- Maps
Obter um ficheiro
Transfira um ficheiro a partir do armazenamento GIS Cloud.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud 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 no armazenamento SaaS |
Devoluções
- response
- file
Obter um mapa
Obtenha um objeto GIS Cloud Map.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado para identificar um mapa específico |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
Devoluções
- Body
- Map
Obter uma camada
Obtenha todo o GIS Cloud Layer Object.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
Expandir atributos
|
expand | string |
Expandir a resposta por uma das opções Enum |
Devoluções
- Body
- Layer
Obter uma mídia arquivada no campo Recurso
Obtenha um arquivo de mídia de um campo GIS Cloud Feature Object em um objeto de camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Descarregar Ficheiro
|
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 feição em uma determinada camada |
|
ID do recurso
|
feature_id | True | integer |
O ID de recurso interno usado para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
Devoluções
- response
- file
Recurso de atualização
Atualize um objeto de recurso do GIS Cloud em um objeto de camada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do recurso
|
feature_id | True | integer |
O ID de recurso interno usado para identificar um recurso específico |
|
ID da camada
|
layer_id | True | integer |
O Id da camada interna usado para identificar uma camada específica |
|
payload
|
payload | dynamic |
Os novos dados do recurso a serem atualizados |
Remover um ficheiro
Remove um ficheiro no armazenamento GIS Cloud.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
Nome do arquivo
|
file_name | True | string |
Nome de um arquivo de mídia específico no armazenamento SaaS |
|
Caminho para o arquivo
|
path_to_a_file | True | string |
O caminho relativo para um arquivo específico |
Renderizar um mapa
Renderize a imagem de um objeto GIS Cloud Map.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Chave de API
|
API-Key | True | password |
Chave de API do GIS Cloud usada para autorizar a operação |
|
ID do Mapa
|
map_id | True | integer |
O ID do mapa interno usado 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 layerlist como visível na imagem |
|
|
Imagem Salva
|
justgenerate | number |
Basta gerar a imagem sem salvar |
Devoluções
- response
- file
Definições
Maps
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de Registos
|
total | integer |
Contagem total de registos que podem ser recuperados |
|
Página Atual
|
page | integer |
O número da página que é retornada |
|
Mapear objetos
|
data | array of Map |
Matriz de objetos de mapa retornados |
Map
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do mapa
|
id | integer |
ID interno deste Mapa |
|
Nome
|
name | string |
Nome do Mapa |
|
Objeto do proprietário
|
owner | array of string |
Objeto do proprietário do mapa. Esse valor só aparece se o parâmetro expand contiver a chave 'owner' |
|
Active
|
active | string |
O mapa está ativo |
|
Direitos de autor
|
copyright | string |
String da declaração de direitos autorais |
|
Proj4
|
proj4 | string |
Proj4 projeção de mapa |
|
Unidades Proj4
|
units_proj4 | string |
Unidades da definição do Proj4 |
|
Código EPSG
|
epsg | string |
Código de projeção do mapa EPSG |
|
Unidades do Mapa
|
units | string |
Unidades cartográficas (metro, pé ou foot_us) |
|
Zoom máximo
|
maxzoom | string |
Zoom máximo |
|
Cor de fundo
|
bgcolor | string |
Cor de fundo do mapa |
|
Modificado em
|
modified | integer |
O último mapa de tempo foi modificado (carimbo de data/hora UNIX) |
|
Acesso em
|
accessed | integer |
O último mapa de tempo foi acessado (carimbo de data/hora do UNIX) |
|
Criado em
|
created | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Ver Contagem
|
visited | string |
Número de visualizações do mapa |
|
Arquivado
|
archived | string |
É mapa arquivado |
|
ID do Recurso
|
resource_id | string |
resource_id |
|
Unidade de Medida
|
measure_unit | string |
measure_unit |
|
Visível
|
visible | string |
visível |
|
Objeto de recurso
|
resource | Resource |
Mapear objeto de recurso |
|
Description
|
description | string |
Descrição do mapa |
|
acesso móvel
|
mobileacess | string |
acesso móvel |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
tipo de mapa
|
maptype | string |
tipo de mapa |
|
assets
|
assets | string |
assets |
|
classificação
|
rating | string |
classificação |
|
partilhar
|
share | string |
partilhar |
|
Limites xMin
|
bounds.xmin | float |
Xmin |
|
Limites xMax
|
bounds.xmax | float |
XMÁX |
|
Limites yMin
|
bounds.ymin | float |
ymin |
|
Limites yMax
|
bounds.ymax | float |
Ymax |
|
dependente
|
bound | string |
dependente |
Resource
Mapear objeto de recurso
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Recurso
|
id | integer |
ID interna deste recurso |
|
Tipo de Recurso
|
type | string |
Tipo enumerado de recurso |
|
Localização do recurso
|
location | string |
TBC com valores potencialmente nulos |
|
ID do Recurso
|
target_resource_id | string |
resource_id |
|
ID do proprietário do recurso
|
owner_id | string |
ID de Utilizador do Utilizador proprietário deste Recurso |
|
ID pai do recurso
|
parent_id | string |
TBC com valores potencialmente nulos |
|
ID da Subscrição de Pagamento de Recursos
|
payment_subscription_id | string |
TBC com valores potencialmente nulos |
|
ID de pagamento do recurso
|
payment_id | string |
TBC com valores potencialmente nulos |
|
Obs ID de Pagamento de Recursos
|
payment_id_obs | string |
TBC com valores potencialmente nulos |
|
Recurso arquivado
|
archived | string |
Indica se o recurso foi arquivado |
|
Recurso desativado
|
disabled | string |
TBC com valores potencialmente nulos |
|
Tempo de acesso aos recursos
|
access_time | object |
O recurso de tempo foi acessado pela última vez |
|
Modificado em
|
modified | integer |
O recurso da última vez foi modificado (carimbo de data/hora do UNIX) |
|
Criado em
|
created | integer |
Hora em que o recurso foi criado (carimbo de data/hora UNIX) |
Camadas
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de Registos
|
total | integer |
Contagem total de registos que podem ser recuperados |
|
Página Atual
|
page | integer |
O número da página que é retornada |
|
Objetos de camada
|
data | array of Layer |
Matriz de objetos de camada retornados |
Camada
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da camada
|
id | integer |
A ID interna da camada |
|
Nome da camada
|
name | string |
Nome da camada definido pelo usuário |
|
Objeto do proprietário
|
owner | array of string |
Objeto proprietário da camada, EXPANSÍVEL |
|
Tipo de origem da camada
|
source.type | string |
Tipo de dados fornecidos |
|
URI de origem da camada
|
source.src | string |
Cadeia de caracteres URI que define onde os dados estão |
|
Em escala
|
onscale | string |
Definir escala em qual camada é visível |
|
Fora de escala
|
offscale | string |
Definir escala na camada que está oculta |
|
Rótulo da camada
|
label | string |
Nome do atributo da fonte de dados a ser usado para um rótulo de linha |
|
x Mínimo
|
x_min | string |
Coordenada X min ligada à camada |
|
x Máximo
|
x_max | string |
Coordenada X max ligada à camada |
|
y Min
|
y_min | string |
Coordenada Y min ligada à camada |
|
y Máximo
|
y_max | string |
Coordenada máxima Y ligada à camada |
|
Campo de texto da camada
|
textfield | string |
Nome do atributo da fonte de dados a ser usado como campo de texto |
|
Modificado em
|
modified | integer |
O último mapa de tempo foi 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 da fonte de dados de camada
|
encoding | string |
Codificação da fonte de dados de camada |
|
Margem de texto da camada
|
margin | string |
Margem do 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 raster
|
raster | string |
Layer é uma fonte de dados 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 da pasta pai |
|
Dica de ferramenta de camada
|
tooltip | string |
A dica de ferramenta que aparece na camada apresenta o mouse pairando |
|
Ocultar geometria
|
hidegeometry | string |
Ocultar a geometria da 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 da camada em um pop-up de mapa, 't' ou 'f' |
|
ID da fonte de dados de camada
|
datasource_id | string |
ID da fonte de dados da fonte de dados da camada |
|
Camada EPSG
|
epsg | string |
Código EPSG da fonte de dados |
|
Camada aberta
|
opened | string |
Para o valor booleano 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 camada
|
map_id | string |
ID do mapa a que a camada pertence |
|
Tipo de geom de camada
|
type | string |
Tipo de geometria da camada. Os valores possíveis são 'ponto', 'linha', 'polígono', 'mosaico' e 'wms'. |
|
Ordem da camada
|
order | integer |
Índice da camada Z |
|
Objeto de opções de camada
|
options | object |
Lista de opções vinculadas a este recurso. Este valor só aparece se o parâmetro expand 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 da 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, EXPANSÍVEL |
|
subcamadas
|
sublayers | array of Layer |
Matriz de objetos de camada aninhados nesta camada |
User
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de Utilizador
|
id | integer |
ID de usuário exclusivo |
|
Tipo de Utilizador
|
type | string |
Tipo especificado de usuário |
|
Usuário Ativo
|
active | string |
O usuário está ativo, 't' ou 'f' |
|
Nome de utilizador
|
username | string |
Nome de utilizador dos utilizadores |
|
Nome do usuário
|
firstname | string |
Nome do usuário |
|
Apelido do Utilizador
|
lastname | string |
Apelido dos Utilizadores |
|
ID do proprietário do usuário
|
owner_id | string |
ID de Utilizador do Utilizador proprietário deste Utilizador |
|
Telefone do usuário
|
phone | string |
Número de telefone dos usuários |
|
Móvel do usuário
|
mobile | string |
Número de telemóvel dos utilizadores |
|
Criado em
|
created | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Último Login
|
lastlog | integer |
Hora em que o mapa foi criado (carimbo de data/hora UNIX) |
|
Empresa Utilizadora
|
company | string |
Nome da Empresa dos Utilizadores |
|
URL da Web do usuário
|
web | string |
Site de Perfil de Usuário |
|
E-mail do usuário
|
string |
Endereço de e-mail dos usuários |
|
|
Avatar do usuário
|
avatar | string |
URL para recuperar avatar de usuários |
|
Língua do Utilizador
|
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 de banco de dados
|
db_feature_count | string |
Contagem de recursos geográficos no banco de dados |
|
Raster do 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 licenciada |
|
Limite de varredura do usuário
|
storage_raster_limit | string |
Capacidade máxima de armazenamento licenciada |
|
Começa a subscrição
|
subscription_begins | string |
Quando a subscrição de utilizadores começa |
|
A subscrição expira
|
subscription_expires | string |
Quando a subscrição dos utilizadores termina |
|
ID de recurso do usuário
|
resource_id | string |
ID de recurso interno para este usuário |
|
Usuário modificado pela última vez
|
modified | integer |
Data hora da última modificação (formato UNIX) |
|
Organização de Usuários
|
organization_id | string |
ID da organização para este usuário |
|
Usuário OIDC
|
oidc | string |
OpenID Connect |
|
Opções do Utilizador
|
options | string |
Lista de opções vinculadas ao usuário. Este valor só aparece se o parâmetro 'expand' contiver a chave 'options' |
|
consentimentos
|
consents | array of object |
Contratos de consentimento do utilizador Objeto |
|
Finalidade do 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 |
O consentimento foi concedido? |
ficheiro
Este é o tipo de dados básicos 'arquivo'.