Una funzionalità particolarmente utile di Portal for ArcGIS è la possibilità di mappare indirizzi da un file CSV o una tabella. Per poterla utilizzare, è necessario assicurarsi che nel Portale sia disponibile un servizio di utilità di geocodifica valido che consenta di cercare gli indirizzi ed un server di hosting che consenta di leggere gli indirizzi ed inviarli al servizio di utilità di geocodifica.
Impostare un servizio di utilità di geocodifica
È necessario impostare un servizio di utilità di geocodifica per il portale per geocodificare contemporaneamente un elevato numero di indirizzi, come quando si aggiunge al map viewer un file CSV che include indirizzi. È possibile utilizzare un servizio di geocodifica da un'organizzazione ArcGIS Online o è possibile configurare un proprio servizio di geocodifica che viene eseguito su un GIS Server federato o un GIS Server autonomo.
Per ulteriori informazioni su come impostare un servizio di utilità di geocodifica, vedere Configurare i servizi di utilità. Per informazioni su come configurare un servizio di geocodifica personale consultare la sezione che segue.
Configurare un servizio di geocodifica personale
Portal for ArcGIS utilizza il servizio di geocodifica mondiale predefinito ospitato in ArcGIS Online. Se l'organizzazione dispone di un proprio localizzatore dati per individuare indirizzi e nomi di luoghi o se il portale non ha accesso ad ArcGIS Online, è possibile pubblicare un servizio di geocodifica e utilizzarlo come servizio di utilità di geocodifica del portale.
Abilitare le funzionalità Suggerisci nel servizio di utilità di geocodifica personalizzato se si desidera visualizzare suggerimenti relativi a indirizzi ed a nomi di luoghi quando gli utenti effettuano una ricerca nel map viewer.
- Seguire le istruzioni in Creare un localizzatore di indirizzi presenti nella Guida di ArcGIS Desktop per creare un localizzatore basato sui propri dati. Se si desidera utilizzare i suggerimenti presenti nel map viewer del portale, selezionare l'opzione Suggerisci presente nello strumento Crea localizzatore indirizzi al momento della creazione del localizzatore stesso.
- Pubblicare il localizzatore come servizio facendo clic con il pulsante destro del mouse sul localizzatore nell'albero del catalogo di ArcGIS Desktop e poi fare clic su Condividi come servizio.
Per maggiori informazioni sulla pubblicazione di un servizio, consultare Come pubblicare un servizio nella Guida di ArcGIS Server.
- Se, al momento della creazione del localizzatore, non sono stati abilitati i suggerimenti, è possibile abilitarli sul servizio di geocodifica dopo la sua pubblicazione. Aprire Editor servizio per il servizio in ArcGIS Desktop o ArcGIS Server Manager, fare clic sulla scheda Funzionalità e selezionare l'operazione Suggerisci.
- Configurare il servizio così ottenuto come servizio di geocodifica del portale seguendo le relative istruzioni presenti in Configurare i 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 proprio Data Store relazionale configurato.
- Installare ArcGIS Data Store.
- 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.
- Scegliere il sito di GIS Server nell'elenco a discesa nella sezione Server di hosting del riquadro Server.
- Fare clic su Salva.
Configurare lo strumento Geocodifica località da tabella per utilizzare Mondo Esri - Geocodificatore batch
Per impostazione predefinita, il servizio Mondo Esri - Geocodificatore batch viene condiviso con l'organizzazione quando viene configurato come servizio di utilità. Per consentire agli utenti e agli editori nell'organizzazione di inviare richieste di geocodifica batch rispetto al servizio Mondo Esri - Geocodificatore batch utilizzando lo strumento Geocodifica località da tabella, è anche necessario condividere Mondo Esri - Geocodificatore batch con Tutti.
- Selezionare I miei contenuti.
- Fare clic sull'elemento del localizzatore Mondo AGO - Geocodificatore per aprire la relativa pagina dei dettagli.
- Fare clic su Condividi nella scheda Panoramica e selezionare Tutti.
- Fare clic su OK.
Utilizzando lo strumento Mondo Esri - Geocodificatore batch nello strumento Geocodifica località da tabella si consumano crediti nell'organizzazione ArcGIS Online utilizzata per configurare il servizio di utilità di geocodifica. Il l numero di richieste di geocodifica batch simultanee per Mondo Esri - Geocodificatore batch non può essere configurato ed è sempre impostato su uno. Utilizzando qualsiasi altro servizio localizzatore con lo strumento Geocodifica località da tabella non si consumeranno crediti e altri localizzatori possono essere configurati per inviare più richieste di geocodifica batch simultanee.
Configurare il numero consigliato di richieste di geocodifica batch simultanee per il servizio di utilità di geocodifica
Il servizio di utilità di geocodifica 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 servizio di utilità di geocodifica, le prestazioni del servizio di geocodifica 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 di utilità di geocodifica, 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 di utilità di geocodifica 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 di utilità di geocodifica che per il servizio di geocodifica. Ad esempio, se sono presenti 8 istanze disponibili per il servizio di utilità di geocodifica e 2 istanze disponibili per il servizio di geocodifica, il numero consigliato di richieste di geocodifica batch simultanee deve essere impostato su 4. Durante l'esecuzione del servizio di geocodifica, il servizio invierà quattro richieste di geocodifica batch simultanee al servizio di utilità di geocodifica. Se è necessario un numero maggiore di istanze disponibili per il servizio di utilità di geocodifica, il numero consigliato di richieste di geocodifica batch simultanee deve essere adeguato di conseguenza in modo da ottimizzare l'utilizzo delle istanze da parte del servizio di utilità di geocodifica.
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 di utilità di geocodifica, effettuare i seguenti passaggi:
- 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.
- Passare a Home > Portali > Personale.
- Fare clic su Aggiorna nella parte inferiore della pagina.
- Nella casella di testo Servizio Geocodifica verranno visualizzati i servizi di utilità di geocodifica attualmente configurati con il portale. Per i servizi di utilità di geocodifica che consentono la geocodifica batch (identificabili grazie alla proprietà batch impostata su true), è possibile configurare il numero consigliato di richieste di geocodifica batch simultanee. Scegliere il geocodificatore 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 }] - Aggiungere la proprietà numBatchThreads a tutti i servizi di utilità di geocodifica 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 di utilità di geocodifica specifico, quindi impostare la proprietà su tale valore. Notare che per poter configurare numBatchThreads sul servizio di utilità di geocodifica, è necessario che batch sia 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 }] - Dopo aver aggiornato l'istruzione JSON nella casella di testo Servizio Geocodifica, fare clic su Aggiorna organizzazione nella parte inferiore della pagina.
Il valore url del servizio di utilità di geocodifica con la proprietà numBatchThreads aggiunta deve essere utilizzato 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.