Skip To Content

Configurare il portale per la geocodifica di indirizzi

Una feature utile dei portali ArcGIS Enterprise è la capacità di mappare indirizzi e nomi di luoghi da un file Comma Separated Values (CSV), un file Microsoft Excel o una tabella. Per poterla utilizzare, è necessario assicurarsi che nel Portale sia disponibile un servizio locator valido che consenta di cercare gli indirizzi o i luoghi ed un server di hosting che consenta di leggere gli indirizzi o i luoghi ed inviarli al servizio locator.

Legacy:

I servizi locator erano precedentemente chiamati servizi di geocodifica. Certe aree dell'interfaccia utente e dell'API del software usano il termine servizio di geocodifica per garantire la compatibilità con le versioni precedenti.

Impostare un servizio locator

È necessario impostare un servizio locator per il portale per geocodificare contemporaneamente un elevato numero di indirizzi o nomi di luoghi, come quando si aggiunge al Map Viewer un file CSV che include indirizzi. È possibile usare un servizio locator da un'organizzazione ArcGIS Online o pubblicare il proprio servizio locator (geocodifica) su uno dei server federati del portale o un GIS Server indipendente.

È necessario configurare il servizio locator di ArcGIS Online, con la geocodifica batch abilitata, per consentire agli utenti di creare visualizzazioni da locator. Se il proxy del servizio di geocodifica di ArcGIS Online viene eliminato, le visualizzazioni da locator non funzioneranno più. Se si è configurato il servizio locator di ArcGIS Online prima dell'aggiornamento a ArcGIS Enterprise 10.6.1, sarà necessario disabilitare e abilitare nuovamente il servizio di utilità di geocodifica per ArcGIS Online per supportare le visualizzazioni da locator.

Per ulteriori informazioni su come impostare un locator nel portale per abilitare la geocodifica, consultare Configurare i servizi di utilità. Per informazioni su come configurare il proprio servizio consultare la sezione che segue.

Configurare il proprio servizio locator

I portali ArcGIS Enterprise usano l' ArcGIS World Geocoding Service hosted in ArcGIS Online per impostazione predefinita. Se l'organizzazione dispone di un proprio locator dati per individuare indirizzi e nomi di luoghi o se il portale non ha accesso ad ArcGIS Online, è possibile pubblicare un servizio locator (geocodifica) e impostarlo come locator del portale.

Abilitare le funzionalità Suggerisci nel servizio locator se si desidera visualizzare suggerimenti relativi a indirizzi e a nomi di luoghi quando gli utenti effettuano una ricerca nel Map Viewer.

  1. Seguire le istruzioni in Creare un locator di indirizzi presenti nella Guida di ArcMap per creare un locator basato sui propri dati. Se si desidera utilizzare i suggerimenti presenti nel Map Viewer, selezionare l'opzione Suggerisci presente nello strumento Crea localizzatore indirizzi al momento della creazione del localizzatore stesso.
  2. Pubblicare il locator come servizio facendo clic con il pulsante destro del mouse sul locator nell'albero del catalogo di ArcMap o ArcCatalog e poi facendo clic su Condividi come servizio.

    Per maggiori informazioni sulla pubblicazione di un servizio, consultare Come pubblicare un servizio nella Guida di ArcGIS Server.

  3. Se, al momento della creazione del locator, non sono stati abilitati i suggerimenti, è possibile abilitarli sul servizio di localizzazione dopo la sua pubblicazione. Aprire Editor servizio per il servizio in ArcMap o ArcGIS Server Manager, fare clic sulla scheda Funzionalità e selezionare l'operazione Suggerisci.
  4. Configurare il servizio risultante come locator per il portale. Passare a Organizzazione > Modifica impostazioni > Servizi di utilità.

Configurare un Data Store relazionale con GIS Server

Il sito di GIS Server impostato come server di hosting del portale deve disporre di un Data Store relazionale ArcGIS Data Store configurato.

  1. Installare ArcGIS Data Store.
  2. Creare un Data Store relazionale.

    Durante la creazione del Data Store relazionale specificare l'URL del sito di GIS Server che si desidera utilizzare come server di hosting del portale.

Federare GIS Server con il portale

Prima di poter designare un sito di GIS Server come server di hosting, è necessario federarlo con il portale. Il sito di GIS Server federato con il portale deve essere configurato per la comunicazione mediante HTTP e HTTPS o solo HTTPS.

Per istruzioni, consultare Federare un sito di ArcGIS Server con il portale.

Designare il server di hosting

Specificare il sito di GIS Server federato con il portale come server di hosting.

  1. Scegliere il sito di GIS Server nell'elenco a discesa nella sezione Server di hosting del riquadro Server.
  2. Fare clic su Salva.

Configurare lo strumento Geocodifica posizione da tabella per utilizzare Mondo Esri - Geocodificatore batch e Visualizzazioni da locator

Per impostazione predefinita, il servizio Mondo Esri - Geocodificatore batch viene condiviso con l'organizzazione. Per impostazione predefinita, le visualizzazioni da locator del Mondo Esri - Geocodificatore batch non sono condivise. Per inviare richieste di geocodifica batch rispetto al servizio Mondo Esri - Geocodificatore batch e rispetto alle visualizzazioni da locator utilizzando lo strumento Geocodifica posizione da tabella o utilizzando Geocodifica tabella, è necessario condividere il servizio con tutti.

  1. Passare alla scheda I miei contenuti della pagina del contenuto.
  2. Fare clic sul locator Mondo AGO - Geocodificatore o sulla visualizzazione del locator corrispondente che deve essere condivisa, quindi aprire la pagina dei dettagli del suo elemento.
  3. Fare clic su Condividi nella scheda Panoramica e selezionare Tutti.
  4. Fare clic su OK.

Utilizzando lo strumento Mondo Esri - Geocodificatore batch o una visualizzazione da locator nello strumento Geocodifica posizione da tabella si consumano crediti nell'organizzazione ArcGIS Online utilizzata per configurare il locator (servizio di utilità di geocodifica) del portale. Il numero di richieste di geocodifica batch simultanee per Mondo Esri - Geocodificatore batch e per le visualizzazioni da locator non può essere configurato ed è sempre impostato su uno. Utilizzando qualsiasi altro servizio di locator con lo strumento Geocodifica posizione da tabella non si consumano crediti ed è possibile configurare locator aggiuntivi per inviare più richieste di geocodifica batch simultanee.

Aggiungere accesso per un ulteriore feedback durante la geocodifica batch

Per impostazione predefinita, il livello del messaggio di servizio di geoprocessing GeocodingTools è impostato su Avviso. Per messaggi di errore più dettagliati e per aggiornamenti migliori sullo stato del processo di geocoding batch, è possibile impostare il livello di accesso del servizio di geoprocessing GeocodingTools su Info.

  1. Passare a Server Manager del server di hosting.
  2. Fare clic sulla cartella Utilities nella directory Server Manager.
  3. Fare clic sul servizio di geoprocessing GeocodingTools.
  4. Fare clic sul banner Parametri a sinistra e cambiare Livello messaggio in Info. Quindi,, fare clic sul pulsante Salva e riavvia nell’angolo in alto a destra.

Cambiando il livello di accesso in Info si causa una leggera diminuzione delle prestazioni, ma si fornisce un feedback migliore sull'avanzamento del processo e maggiori informazioni sui possibili errori, qualora si verifichino. Tali vantaggi possono essere osservati nello strumento Geocodifica posizione da tabella e nello strumento Geocodifica tabella.

Configurare il numero consigliato di richieste di geocodifica batch simultanee per il locator

Il locator del portale può essere utilizzato anche dal servizio di geoprocessing GeocodingTools eseguito sul server di GIS Server federato. Il servizio di geoprocessing può inviare più richieste simultanee al servizio di utilità di geocodifica per velocizzare l'esecuzione complessiva della geocodifica batch. Il numero di richieste simultanee effettuate dal servizio di geocodifica può essere configurato da un amministratore del portale. Se il servizio di geocodifica sta inviando un numero eccessivo di richieste simultanee al locator, le sue prestazioni potrebbero risultare scadenti. Ciò potrebbe generare un numero maggiore di errori durante l'esecuzione del servizio di geocodifica. Per questo motivo, l'amministratore deve impostare il numero di istanze utilizzate dal servizio di geocodifica in base al numero di istanze disponibili per il servizio locator, nonché configurare il numero di richieste di geocodifica batch simultanee che è possibile gestire da qualsiasi istanza del servizio di geocodifica GeocodingTools.

Come procedura consigliata, il numero di istanze per il servizio locator deve sempre essere maggiore o uguale al numero di istanze disponibili per il servizio di geocodifica GeocodingTools. Il numero di richieste di geocodifica batch simultanee deve essere impostato in modo proporzionale rispetto al numero di istanze disponibili sia per il servizio locator che per il servizio di geocodifica. Ad esempio, se sono presenti 8 istanze disponibili per il servizio locator e 2 istanze disponibili per il servizio di geocodifica, impostare il numero di richieste di geocodifica batch simultanee su 4. Durante l'esecuzione del servizio di geocodifica, il servizio invia quattro richieste di geocodifica batch simultanee al servizio locator. Se è necessario un numero maggiore di istanze disponibili per il servizio locator, modificare il numero di richieste di geocodifica batch simultanee in modo adeguato per ottimizzare l'utilizzo delle istanze da parte del servizio locator.

Notare che Mondo Esri - Geocodificatore batch non può essere configurato per utilizzare più richieste simultanee. La seguente configurazione si applica a tutti gli altri servizi di localizzazione pubblicati che sono configurati come servizi di utilità.

Per impostare il numero consigliato di richieste di geocodifica batch simultanee per il servizio locator, effettuare i seguenti passaggi:

  1. Passare alla posizione di condivisione della directory di Portal for ArcGIS ed eseguire l'accesso come membro con privilegi amministrativi. Il formato dell'URL è https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
  2. Passare a Home > Portali > Personale.
  3. Fare clic su Aggiorna nella parte inferiore della pagina.
  4. Nella casella di testo Servizio Geocodifica verranno visualizzati i servizi locator attualmente configurati con il portale. Per i servizi che consentono la geocodifica batch (quelli con la proprietà batchimpostata su true), è possibile configurare il numero consigliato di richieste di geocodifica batch simultanee. Scegliere il servizio da configurare con questa proprietà. L'istruzione JSON nella casella di testo Servizio Geocodifica avrà il seguente 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. Aggiungere la proprietà numBatchThreads a tutti i servizi locator che si desidera utilizzare con il servizio di geocodifica GeocodingTools. Per impostare il valore numBatchThreads, determinare innanzitutto il numero di richieste di geocodifica batch simultanee che si desidera abilitare per un servizio locator specifico, quindi impostare la proprietà su tale valore. Per configurare numBatchThreads sul servizio locator, il servizio deve avere batch impostato su true.

    In questo esempio, il numero di richieste di geocodifica batch simultanee consentite per il servizio di utilità Streetmap Premium USA Geocoder è impostato su 4.

    [{
            "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. Dopo aver aggiornato l'istruzione JSON nella casella di testo Servizio Geocodifica, fare clic su Aggiorna organizzazione nella parte inferiore della pagina.

Usare l'url del servizio locator con la proprietà numBatchThreads aggiunta come geocodeServiceURL nelle attività AnalyzeGeocodeInput e BatchGeocode. Per informazioni sull'esecuzione degli strumenti all'interno del servizio GeocodingTools tramite le attività dell'API REST ArcGIS, consultare la documentazione dell'API REST ArcGIS.