Skip To Content

Configurar o portal para endereços de geocódigo

Um recurso útil do Portal for ArcGIS é a habilidade de mapear endereços a partir de um arquivo CSV. Para permitir isto, você deve garantir que o portal tem um serviço do utilitário de geocódigo válido ( para localizar os endereços) e um servidor de hospedagem (para ler os endereços e enviá-los ao serviço do utilitário de geocódigo).

Configurar um serviço do utilitário de geocódigo

Você deve configurar um serviço do utilitário de geocódigo no seu portal para geocodificar vários endereços de cada vez, como quando você adicionar um arquivo CSV que contém endereços no visualizador de mapa. Você pode utilizar um serviço de geocódigo de uma organização do ArcGIS Online ou você pode configurar seu próprio serviço de geocódigo que é executado em um GIS Server federado ou um GIS Server auxiliar.

Consulte Configurar serviços do utilitário para mais informações sobre configurar um serviço do utilitário de geocódigo. Para informações sobre configurar seu próprio serviço de geocódigo, consulte a próxima seção.

Configurar seu próprio serviço de geocódigo

O Portal for ArcGIS utiliza o serviço de geocódigo World hospedado no ArcGIS Online por padrão. Se a sua organização tiver seus próprios dados do localizador para utilizar para encontrar endereços e nomes de lugares ou se o portal não tiver acesso ao ArcGIS Online, publique um serviço de geocódigo e configure como serviço do utilitário de geocódigo do seu portal.

Habilite o recurso Sugestão no seu serviço do utilitário de geocódigo personalizado se você desejar sugestões de nome de lugares e endereços para aparecer quando usuários procurarem no visualizador de mapa.

  1. Siga as instruções em Criando um localizador de endereços na ajuda do ArcGIS Desktop para criar um localizador a partir dos seus dados. Se você desejar o uso de sugestões no visualizador de mapa do portal, marque a opção Sugestão na ferramenta Criar Localizador de Endereços quando criar o localizador.
  2. Publique o localizador como um serviço clicando com o botão direito no localizador na árvore Catálogo do ArcGIS Desktop e selecionando Compartilhar Como Serviço.

    Para mais informações sobre publicar um serviço, consulte Como publicar um serviço na ajuda do ArcGIS Server.

  3. Se você não habilitar as sugestões no localizador quando criá-lo, você poderá habilitar as sugestões no serviço de geocódigo após ser publicado. Abra o Editor de Serviço para o serviço no ArcGIS Desktop ou ArcGIS Server Manager, clique na guia Recursos, e marque a operação Sugestão.
  4. Configure o serviço resultante como o serviço do utilitário de geocódigo do seu portal, seguindo as instruções aplicáveis em Configurar 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 configurado com ele.

  1. Instale o ArcGIS Data Store.
  2. 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.

  1. Escolha o site do GIS Server da lista suspensa na seção Servidor de Hospedagem do painel Servidor.
  2. Clique em Salvar.

Configure a ferramenta Geocodificar Locais da Tabela para utilizar o Esri World Batch Geocoder

Por padrão, o serviço Esri World Batch Geocoder é compartilhado com a organização ao configurá-lo como um serviço de utilitário. Para permitir que usuários e editores da organização enviem solicitações de geocodificação em lote com Esri World Batch Geocoder utilizando a ferramenta Geocodificar Locais da Tabela, você também precisa compartilhar o Esri World Batch Geocoder com Todos.

  1. Navegue até Meu Conteúdo.
  2. Clique no item do localizador AGO World Geocoder para abrir a sua página de detalhes.
  3. Clique em Compartilhar na guia Visão Geral e marque Todos.
  4. Clique em OK.

A utilização do Esri World Batch Geocoder na ferramenta Geocodificar Locais da Tabela consome créditos na organização do ArcGIS Online que você utilizou ao configurar o serviço do utilitário de geocodificação. O número de pedidos da geocodificação em lote concorrentes no Esri World Batch Geocoder não pode ser configurado e é sempre definido como um. A utilização de qualquer outro serviço do localizador com a ferramenta Geocodificar Locais da Tabela não consumirá créditos e outros localizadores poderão ser configurados para enviar múltiplos pedidos de geocodificação em lote concorrentes.

Configurar o número sugerido dos pedidos de geocodificação em lote concorrentes para o serviço do utilitário de geocódigo

O serviço do utilitário de geocódigo 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 geoprocesamento estiver fazendo pedidos concorrentes excessivos ao serviço do utilitário de geocódigo, 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 geoprocesamento baseado no número de instâncias disponíveis para o serviço do utilitário de geocódigo e também configurar o número de pedidos de geocodificação em lote concorrentes que pode ser feito de qualquer instância do serviço de geoprocesamento GeocodingTools.

Como uma melhor prática, o número de instâncias para o serviço do utilitário de geocódigo 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 do utilitário de geocódigo e o serviço de geoprocessamento. Por exemplo, se existir oito instâncias disponíveis para o serviço do utilitário de geocódigo e duas instâncias disponíveis para o serviço de geoprocessamento, o número sugerido de pedidos de geocodificação em lote concorrentes deverá ser configurado para quatro. Quando o serviço de geoprocessamento for executado, ele enviará quatro pedidos de geocodificação em lote concorrentes para o serviço do utilitário de geocódigo. No caso de mais instâncias estarem disponíveis para o serviço do utilitário de geocódigo, o número sugerido de pedidos de geocodificação em lote concorrentes deverá ser apropriadamente ajustado para maximizar a utilização de instâncias para o serviço do utilitário de geocódigo.

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 de geocodificação em lote concorrentes para seu serviço do utilitário de geocódigo, utilize as seguintes etapas:

  1. 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.
  2. Navegue até Página Inicial > Portais > Próprio.
  3. Na parte inferior da página, clique em Atualizar.
  4. Na caixa de texto Serviço de Geocódigo, você visualizará os serviços do utilitário de geocodificação atualmente configurados com o portal. Para os serviços do utilitário de geocódigo que permitem a geocodificação em lote (que podem ser identificados se tiverem a propriedade batchconfigurada para true), você pode configurar o número sugerido de pedidos de geocodificação em lote concorrentes. Escolha o geocodificador 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
        }]

  5. Adicione a propriedade numBatchThreads para todos os serviços do utilitário de geocódigo que você deseja utilizar com o serviço de geoprocessamento GeocodingTools. Para configurar o valor numBatchThreads, primeiro determine o número de pedidos de geocodificação em lote concorrentes que você deseja habilitar para um determinado serviço do utilitário de geocódigo, e configure a propriedade igual a este número. Note que para configurar numBatchThreads no serviço do utilitário de geocodificação, 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
        }]

  6. 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.

A url de serviço do utilitário de geocódigo com a propriedade numBatchThreads adicionada, deve ser utilizada 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.