Um recurso útil de portais do ArcGIS Enterprise é a capacidade de mapear nomes de endereços ou lugares a partir de um arquivo de valores separados por vírgulas (CSV), arquivo do Microsoft Excel ou tabela. Para permitir isto, você deve garantir que o portal tenha um serviço de localizador válido (para encontrar lugares os endereços) e um servidor de hospedagem (para ler os endereços ou lugares e enviá-los ao serviço de localizador).
Validado:
Os serviços de localizador foram anteriormente denominados serviços de geocódigo. Determinadas áreas da interface de usuário do software e API ainda utilizam o termo serviço de geocódigo para compatibilidade com versões anteriores.
Configurar um serviço de localizador
Você deve configurar um serviço de localizador no seu portal para geocodificar vários nomes de endereços ou lugares de uma vez, como quando você adicionar um arquivo CSV que contém endereços no Map Viewer. Você pode utilizar um serviço de localizador a partir de uma organização do ArcGIS Online , ou você pode configurar seu próprio serviço de localizador (geocódigo) para um dos servidores federados do portal ou um GIS Server independente.
O serviço de localizador do ArcGIS Online, com a geocodificação em lote habilitada, deve ser configurado para permitir que usuários criem visualizações de localizador. Se o proxy do serviço de geocódigo do ArcGIS Online for excluído, as visualizações de localizador não funcionarão mais. Se você configurou o serviço de localizador do ArcGIS Online antes de atualizar o ArcGIS Enterprise 10.6.1, então você deverá desabilitar e reabilitar o serviço do utilitário Geocodificar ArcGIS Online para suportar as visualizações do localizador.
Consulte Configurar serviços do utilitário para mais informações sobre configurar um localizador no seu portal para habilitar geocodificação. Para informações sobre configurar seu próprio serviço, consulte a próxima seção.
Configurar seu próprio serviço de localizador
Os portais do ArcGIS Enterprise utilizam o ArcGIS World Geocoding Service hospedado no ArcGIS Online por padrão. Se a sua organização tiver seus próprios dados do localizador a serem utilizados para encontrar nomes de lugares e endereços ou se o portal não tiver acesso ao ArcGIS Online, publique um serviço de localizador (geocódigo) e configure como localizador do seu portal.
Habilite o recurso Sugestão no serviço de localizador se você desejar sugestões de nomes de lugares e endereços para aparecer quando usuários procurarem no Map Viewer.
- Siga as instruções em Criando um localizador de endereços na ajuda do ArcMap para criar um localizador a partir dos seus dados. Se você desejar o uso de sugestões no Map Viewer, marque a opção Sugestão na ferramenta Criar Localizador de Endereços quando criar o localizador.
- Publique o localizador como um serviço clicando com o botão direito no localizador na árvore Catálogo do ArcMap ou ArcCatalog e clicando em Compartilhar como Serviço.
Para mais informações sobre publicar um serviço, consulte Como publicar um serviço na ajuda do ArcGIS Server .
- Se você não habilitar as sugestões no localizador quando criá-lo, você poderá habilitar as sugestões no serviço de localizador após ser publicado. Abra o Editor de Serviço para o serviço no ArcMap ou ArcGIS Server Manager, clique na guia Recursos, e marque a operação Sugestão.
- Configure o serviço resultante como um localizador para seu portal. Vá até Organização > Editar Configurações > Serviços do Utilitário.
Configurar um armazenamento de dados relacional com um GIS Server
O site do GIS Server que você configurou como o servidor de hospedagem do seu portal deve ter um armazenamento de dados relacional do ArcGIS Data Store configurado com ele
- Instale o ArcGIS Data Store.
- Crie um armazenamento de dados relacional.
Ao criar o armazenamento de dados relacional, especifique a URL de site do GIS Server que você deseja utilizar como seu servidor de hospedagem do portal.
Federar o GIS Server com seu portal
Antes de designar o site do GIS Server como um servidor de hospedagem, você deve federá-lo com o portal. O site do GIS Server que você federar com o portal deverá ser configurado para comunicar por HTTP e HTTPS ou HTTPS somente.
Para instruções, consulte Federar um site do ArcGIS Server com seu portal.
Designar o servidor de hospedagem
Especifique o site do GIS Server que você acabou de federar com seu portal como o servidor de hospedagem.
- Escolha o site do GIS Server da lista suspensa na seção Servidor de Hospedagem do painel Servidor.
- Clique em Salvar.
Configurar a ferramenta Geocodificar Locais da Tabela para utilizar o Esri World Batch Geocoder e Visualizações do Localizador l v
Por padrão, o serviço Esri World Batch Geocoder é compartilhado com a organização. As visualizações do localizador no Esri World Batch Geocoder não são compartilhadas por padrão. Para enviar pedidos de geocodificação em lote no Esri World Batch Geocoder e em visualizações do localizador utilizando a ferramenta Geocodificar Locais da Tabela ou utilizando Geocodificar Tabela, você precisa compartilhar o serviço com todos.
- Navegue até a guia Meu Conteúdo da página de conteúdo.
- Clique no localizador AGO World Geocoder , ou na visualização de localizador correspondente que precisa ser compartilhada e abra sua página de detalhes do item.
- Clique em Compartilhar na guia Visão Geral e marque Todos.
- Clique em OK.
A utilização do Esri World Batch Geocoder ou uma visualização de localizador na ferramenta Geocodificar Local da Tabela consome créditos na organização do ArcGIS Online que você utiliza ao configurar o localizador do portal (serviço do utilitário de geocodificação). O número de pedidos da geocodificação em lote concorrentes no Esri World Batch Geocoder e para visualizações de localizador não pode ser configurado e é sempre definido como um. A utilização de qualquer outro serviço de localizador com a ferramenta Geocodificar Locais da Tabela não consome créditos, e você pode configurar localizadores adicionais para enviar múltiplos pedidos de geocodificação em lote concorrentes.
Adicione log para mais comentários durante a geocodificação em lote
Por padrão, o nível de mensagem do serviço de geoprocessamento das Ferramentas de Geocodificação é definido como Aviso. Para obter mensagens de erro mais detalhadas, e para obter melhores atualizações sobre o status do seu trabalho de geocodificação em lote, você pode definir o nível de registro do serviço de geoprocessamento das Ferramentas de Geocodificação para Info.
- Navegue até o Gerenciador do Servidor do seu servidor de hospedagem.
- Clique na pasta Utilitários no diretório do Gerenciador do Servidor.
- Clique no serviço de geoprocessamento the GeocodingTools .
- Clique no banner Parâmetros à esquerda e altere o Nível de Mensagem para Info. Então, clique no botão Salvar e Reiniciar no canto superior direito .
Alterar o nível de registro para Info causará uma ligeira diminuição no desempenho, mas fornecerá um melhor retorno de progresso do trabalho e mais informações sobre possíveis erros, caso ocorram. Estes benefícios podem ser vistos tanto na ferramenta Geocodificar Locais da Tabela quanto em Geocodificar Tabela .
Configurar o número sugerido dos pedidos de geocodificação em lote concorrentes para seu localizador
O localizador do portal também pode ser utilizado pelo serviço de geoprocessamento GeocodingTools executando no seu site do GIS Server federado. O serviço de geoprocessamento pode enviar múltiplos pedidos concorrentes ao serviço do utilitário de geocódigo para acelerar a execução global para geocodificação em lote. O número de pedidos concorrentes feitos pelo serviço de geoprocessamento pode ser configurado por um administrador do portal. Se o serviço de geoprocessamento estiver criando pedidos concorrentes excessivos no localizador, ele poderá ter um desempenho ruim e resultar no aumento de falhas ao executar o serviço de geoprocessamento. Por esta razão, o administrador deve configurar o número de instâncias utilizadas pelo serviço de geoprocessamento baseado no número de instâncias disponíveis para o serviço de localizador e também configurar o número de pedidos da geocodificação em lote concorrentes que pode ser feito de qualquer instância do serviço de geoprocessamento GeocodingTools .
Como uma melhor prática, o número de instâncias para o serviço de localizador deve sempre ser maior ou igual ao número de instâncias disponíveis para o serviço de geoprocessamento GeocodingTools . O número de pedidos de geocodificação em lote concorrentes deve ser configurado proporcionalmente ao número de instâncias disponíveis para ambos o serviço de localizador e o serviço de geoprocessamento. Por exemplo, se existir oito instâncias disponíveis para o serviço de localizador e duas instâncias disponíveis para o serviço de geoprocessamento, os pedidos de geocodificação em lote concorrentes deverão ser configurados para quatro. Quando o serviço de geoprocessamento for executado, ele enviará quatro pedidos de geocodificação em lote concorrentes para o serviço de localizador. No caso de mais instâncias estarem disponíveis para o serviço de localizador, ajuste o número de pedidos da geocodificação em lote concorrentes apropriadamente para maximizar a utilização de instâncias para o serviço de localizador.
Note que o Esri World Batch Geocoder não pode ser configurado para utilizar mais pedidos concorrentes. A seguinte configuração se aplica a todos os outros serviços de localizador publicados que são configurados como serviços do utilitário.
Para configurar o número sugerido de pedidos da geocodificação em lote concorrentes para seu serviço de localizador, utilize as seguintes etapas:
- Vá até o local de compartilhamento do Portal for ArcGIS Directory e entre como um membro com privilégios administrativos. A URL está no formato https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
- Navegue até Página Inicial > Portais > Próprio.
- Na parte inferior da página, clique em Atualizar.
- Na caixa de texto Serviço de Geocódigo você visualizará os serviços de localizador atualmente configurados com o portal. Para os serviços que permitem a geocodificação em lote (aqueles serviços que têm a propriedade batchconfigurada para true), você pode configurar o número sugerido de
pedidos da geocodificação em lote concorrentes. Escolha o serviço que você deseja configurar com esta propriedade. O JSON na caixa de texto Serviço de Geocódigo estará no seguinte formato:
[{ "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "northLat" : "Ymax", "southLat" : "Ymin", "eastLon" : "Xmax", "westLon" : "Xmin", "name" : "Esri World Geocoder", "batch": false, "suggest" : true }, { "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer", "name" : "Streetmap Premium USA Geocoder", "placeholder" : "Find address or place", "singleLineFieldName" : "SingleLine", "batch" : true, "placefinding" : true, "suggest" : true, "zoomScale" : 10000 }] - Adicione a propriedade numBatchThreads para todos os serviços de localizador que você deseja utilizar com o serviço de geoprocessamento GeocodingTools . Para configurar o valor numBatchThreads, primeiro determine o número de pedidos da geocodificação em lote concorrentes que você deseja habilitar para um determinado serviço de localizador, e configure a propriedade igual a este número. Note que para configurar numBatchThreads no serviço de localizador, ele deve ter batch configurado para true.
Neste exemplo, o número de pedidos de geocodificação em lote concorrentes permitidos para o serviço do utilitário Streetmap Premium USA Geocoder está configurado para quatro.
[{ "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "northLat" : "Ymax", "southLat" : "Ymin", "eastLon" : "Xmax", "westLon" : "Xmin", "name" : "Esri World Geocoder", "batch": false, "suggest" : true }, { "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer", "name" : "Streetmap Premium USA Geocoder", "placeholder" : "Find address or place", "singleLineFieldName" : "SingleLine", "batch" : true, "placefinding" : true, "suggest" : true, "zoomScale" : 10000, "numBatchThreads" : 4 }] - Após você ter atualizado o JSON na caixa de texto Serviço de Geocódigo, clique em Atualizar Organização na parte inferior da página.
Utilize a url do serviço de localizador com a propriedade numBatchThreads adicionada como geocodeServiceURL nas tarefas AnalyzeGeocodeInput e BatchGeocode . Para informações sobre executar as ferramentas dentro do serviço GeocodingTools através das tarefas do ArcGIS REST API, consulte a documentação do ArcGIS REST API.