Skip To Content

Konfigurieren des Portals zum Geokodieren von Adressen

Eine hilfreiche Funktion des ArcGIS Enterprise-Portals ist das Hinzufügen von Adressen oder Ortsnamen aus einer CSV-Datei (Comma Separated Values), Microsoft Excel-Datei oder Tabelle. Um dies zu ermöglichen, müssen Sie sicherstellen, dass das Portal über einen gültigen Locator-Service (zum Suchen der Adressen oder Orte) und einen Hosting-Server (zum Lesen und Senden der Adressen oder Orte an den Locator-Service) verfügt.

Ältere Versionen:

Locator-Services wurden zuvor als Geokodierungsservices bezeichnet. In bestimmten Bereichen der Software-Benutzeroberfläche und der API wird der Begriff Geokodierungsservice aus Gründen der Abwärtskompatibilität noch verwendet.

Festlegen eines Locator-Service

Sie müssen einen Locator-Service für das Portal festlegen, um eine große Anzahl von Adressen oder Ortsnamen gleichzeitig geokodieren zu können, z. B. wenn Sie eine CSV-Datei mit Adressen zu Map Viewer hinzufügen. Sie können einen Locator-Service aus einer ArcGIS Online-Organisation verwenden oder einen eigenen Locator-Service (Geokodierungsservice) auf einem der Verbundserver des Portals oder auf einem eigenständigen GIS Server veröffentlichen.

Der Locator-Service von ArcGIS Online mit aktivierter Batch-Geokodierung muss so konfiguriert werden, dass Benutzer Locator-Sichten erstellen können. Wird der ArcGIS Online-Geokodierungs-Proxy-Service gelöscht, funktionieren die Locator-Sichten nicht mehr. Wurde der Locator-Service von ArcGIS Online vor der Aktualisierung auf ArcGIS Enterprise 10.6.1 konfiguriert, müssen Sie den ArcGIS Online-Geokodierungs-Utility-Service deaktivieren und dann erneut aktivieren, damit Locator-Sichten unterstützt werden.

Weitere Informationen über das Festlegen eines Locators im Portal zur Aktivierung der Geokodierung finden Sie unter Konfigurieren von Utility-Services. Informationen zum Konfigurieren Ihres eigenen Service finden Sie im nächsten Abschnitt.

Konfigurieren eines eigenen Locator-Service

Standardmäßig verwenden ArcGIS Enterprise-Portale den in ArcGIS Online gehosteten ArcGIS World Geocoding Service. Wenn Ihre Organisation über eigene Locator-Daten für die Suche nach Adressen und Ortsnamen verfügt oder Ihr Portal keinen Zugriff auf ArcGIS Online hat, veröffentlichen Sie einen Locator-Service (Geokodierungsservice), und legen Sie diesen als Locator für das Portal fest.

Wenn den Benutzern bei der Suche in Map Viewer Adress- oder Ortsnamenvorschläge angezeigt werden sollen, aktivieren Sie im Locator-Service die Funktionen zum Vorschlagen.

  1. Befolgen Sie die Anweisungen in Erstellen eines Adressen-Locators in der Hilfe zu ArcMap, um einen Locator aus Ihren Daten zu erstellen. Wenn Sie in Map Viewer Vorschläge verwenden möchten, aktivieren Sie beim Erstellen des Locators im Werkzeug Adressen-Locator erstellen die Option Vorschlagen.
  2. Veröffentlichen Sie den Locator als Service, indem Sie im Kataloginhaltsverzeichnis von ArcMap oder ArcCatalog mit der rechten Maustaste auf den Locator und anschließend auf Als Service freigeben klicken.

    Weitere Informationen zum Veröffentlichen eines Service finden Sie unter So veröffentlichen Sie einen Service in der ArcGIS Server-Hilfe.

  3. Wenn Sie beim Erstellen des Locators keine Vorschläge in diesem aktiviert haben, können Sie dies im Locator-Service nach dessen Veröffentlichung nachholen. Öffnen Sie den Service-Editor für den Service in ArcMap oder in ArcGIS Server Manager, klicken Sie auf die Registerkarte Funktionen, und aktivieren Sie die Option Vorschlagen.
  4. Konfigurieren Sie den resultierenden Service als Locator für das Portal. Wechseln Sie zu Organisation > Einstellungen bearbeiten > Utility-Services.

Konfigurieren eines relationalen Data Store mit einem GIS Server

Mit der GIS Server-Site, die Sie als Hosting-Server des Portals festgelegt wird, muss ein ArcGIS Data Store vom Typ "relational" konfiguriert sein.

  1. Installieren Sie ArcGIS Data Store.
  2. Erstellen Sie einen relationalen Data Store.

    Geben Sie beim Erstellen des relationalen Data Store die URL der GIS Server-Site an, die Sie als Hosting-Server des Portals verwenden möchten.

Verbinden Sie den GIS Server mit Ihrem Portal.

Bevor Sie eine GIS Server-Site als Hosting-Server festlegen können, müssen Sie sie mit dem Portal verbinden. Die GIS Server-Site, die Sie mit dem Portal verbinden, muss so konfiguriert werden, dass sie über HTTP und HTTPS oder aber nur über HTTPS kommuniziert.

Vollständige Anweisungen finden Sie unter Verbinden einer ArcGIS Server-Site mit dem Portal.

Festlegen des Hosting-Servers

Legen Sie die GIS Server-Site, die Sie soeben mit Ihrem Portal verbunden haben, als Hosting-Server fest.

  1. Wählen Sie die GIS Server-Site aus der Dropdown-Liste im Abschnitt Hosting-Server des Bereichs Server aus.
  2. Klicken Sie auf Speichern.

Konfigurieren des Werkzeugs "Positionen aus Tabelle geokodieren" für die Verwendung des Esri World Batch Geocoder und der Locator-Sichten

Der Service Esri World Batch Geocoder wird standardmäßig für die Organisation freigegeben. Locator-Sichten des Esri World Batch Geocoder werden standardmäßig nicht freigegeben. Damit Batch-Geokodierungsanforderungen für den Esri World Batch Geocoder und die Locator-Sichten mit dem Werkzeug Positionen aus Tabelle geokodieren oder mit Tabelle geokodieren übermittelt werden können, müssen Sie den Service für Alle freigeben.

  1. Klicken Sie auf der Inhaltsseite auf die Registerkarte Eigene Inhalte.
  2. Klicken Sie auf den Locator AGO World Geocoder oder die Locator-Sicht, die freigegeben werden soll, um die Detailseite des Elements zu öffnen.
  3. Klicken Sie auf der Registerkarte Übersicht auf Freigeben, und aktivieren Sie Alle.
  4. Klicken Sie auf OK.

Für die Verwendung des Esri World Batch Geocoder oder einer Locator-Sicht im Werkzeug Positionen aus Tabelle geokodieren werden Credits in der ArcGIS Online-Organisation verbraucht, die Sie beim Konfigurieren des Locators (Geokodierungs-Utility-Service) für das Portal genutzt haben. Die Anzahl der gleichzeitigen Batch-Geokodierungsanforderungen für den Esri World Batch Geocoder und für Locator-Sichten kann nicht konfiguriert werden und ist immer auf eins gesetzt. Bei Verwendung eines anderen Locator-Service mit dem Werkzeug Positionen aus Tabelle geokodieren werden keine Credits verbraucht, und Sie können zusätzliche Locators konfigurieren, um mehrere gleichzeitige Geokodierungsanforderungen zu senden.

Hinzufügen der Protokollierung für mehr Feedback während der Batch-Geokodierung

Standardmäßig wird für den Geocoding Tools-Geoverarbeitungsservice die Meldungsebene Warnung festgelegt. Für detailliertere Fehlermeldungen und bessere Aktualisierungen des Status Ihres Batch-Geokodierungsauftrags können Sie für den Geocoding Tools-Geoverarbeitungsservice die Protokollierungsebene Info festlegen.

  1. Navigieren Sie zu Server Manager Ihres Hosting-Servers.
  2. Klicken Sie auf den Ordner Utilities im Server Manager-Verzeichnis.
  3. Klicken Sie auf den Geoverarbeitungsservice GeocodingTools.
  4. Klicken Sie auf das Banner Parameter auf der linken Seite und legen Sie die Meldungsebene auf Info fest. Klicken Sie dann auf die Schaltfläche Speichern und neu starten in der oberen rechten Ecke.

Das Ändern der Protokollierungsebene auf Info führt zwar zu einer leichten Verschlechterung der Performance, ermöglicht aber ein besseres Feedback zum Auftragsfortschritt und stellt mehr Informationen über aufgetretene mögliche Fehler bereit. Diese Vorteile lassen sich sowohl im Werkzeug Positionen aus Tabelle geokodieren als auch im Werkzeug Tabelle geokodieren feststellen.

Konfigurieren der vorgeschlagenen Anzahl gleichzeitiger Batch-Geokodierungsanforderungen für den Locator

Der Locator des Portals kann auch vom Geoverarbeitungsservice GeocodingTools verwendet werden, der auf der verbundenen GIS Server-Site ausgeführt wird. Der Geoverarbeitungsservice kann mehrere gleichzeitige Anforderungen an den Geokodierungs-Utility-Service senden, um die allgemeine Ausführung für die Batch-Geokodierung zu beschleunigen. Die Anzahl der gleichzeitigen Anforderungen des Geoverarbeitungsservice kann von einem Portal-Administrator konfiguriert werden. Sendet der Geoverarbeitungsservice übermäßig viele gleichzeitige Anforderungen an den Locator, kann dies die Performance des Locators beeinträchtigen, was wiederum zu mehr Fehlern beim Ausführen des Geoverarbeitungsservice führen kann. Aus diesem Grund sollte der Administrator die Anzahl der vom Geoverarbeitungsservice verwendeten Instanzen basierend auf der Anzahl der für den Locator-Service verfügbaren Instanzen festlegen und außerdem die Anzahl der gleichzeitigen Batch-Geokodierungsanforderungen konfigurieren, die eine Instanz des Geoverarbeitungsservice GeocodingTools senden kann.

Es empfiehlt sich, dass die Anzahl der Instanzen für den Locator-Service immer größer oder gleich der Anzahl der für den Geoverarbeitungsservice GeocodingTools verfügbaren Instanzen ist. Die Anzahl der gleichzeitigen Batch-Geokodierungsanforderungen sollte proportional zur Anzahl der für den Locator und die Geoverarbeitungsservices verfügbaren Instanzen festgelegt werden. Wenn für den Locator-Service beispielsweise acht Instanzen und für den Geoverarbeitungsservice zwei Instanzen verfügbar sind, sollte die Anzahl der gleichzeitigen Batch-Geokodierungsanforderungen auf vier festgelegt werden. Wird der Geoverarbeitungsservice ausgeführt, sendet er vier gleichzeitige Batch-Geokodierungsanforderungen an den Locator-Service. Falls mehr Instanzen für den Locator-Service zur Verfügung stehen, passen Sie die Anzahl gleichzeitiger Batch-Geokodierungsanforderungen entsprechend an, um die Nutzung der Instanzen für den Locator-Service zu maximieren.

Beachten Sie, dass der Esri World Batch Geocoder nicht für die Verwendung mehrerer gleichzeitiger Anforderungen konfiguriert werden kann. Die folgende Konfiguration wird auf alle anderen veröffentlichten Locator-Services angewendet, die als Utility-Services konfiguriert sind.

Führen Sie die folgenden Schritte aus, um die vorgeschlagene Anzahl gleichzeitiger Batch-Geokodierungsanforderungen für den Locator-Service festzulegen:

  1. Wechseln Sie zum Verzeichnis "Sharing" des Portal for ArcGIS-Verzeichnisses, und melden Sie sich als Mitglied mit Administratorberechtigungen an. Die URL hat das Format https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
  2. Navigieren Sie zu Startseite > Portale > Auto.
  3. Klicken Sie unten auf der Seite auf Update.
  4. Im Textfeld Geokodierungsservice werden die Locator-Services angezeigt, die derzeit mit dem Portal konfiguriert wurden. Für die Services, die Batch-Geokodierung zulassen (Services, deren batch-Eigenschaft auf true gesetzt ist), können Sie die vorgeschlagene Anzahl gleichzeitiger Batch-Geokodierungsanforderungen konfigurieren. Wählen Sie den Service aus, den Sie mit dieser Eigenschaft konfigurierten möchten. Der JSON-Code im Textfeld Geokodierungsservice hat das folgende Format:
    [{
            "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. Fügen Sie die numBatchThreads-Eigenschaft allen Locator-Services hinzu, die Sie mit dem Geoverarbeitungsservice GeocodingTools verwenden möchten. Um den numBatchThreads-Wert einzustellen, legen Sie zunächst die Anzahl der gleichzeitigen Batch-Geokodierungsanforderungen, die Sie für einen angegebenen Locator-Service aktivieren möchten, und dann die Eigenschaft auf diese Anzahl fest. Beachten Sie, dass numBatchThreads auf batch gesetzt sein muss, damit true für den Locator-Service konfiguriert werden kann.

    In diesem Beispiel ist die Anzahl der zulässigen gleichzeitigen Batch-Geokodierungsanforderungen für Geokodierungs-Utility-Service "Streetmap Premium USA" auf vier festgelegt.

    [{
            "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. Nachdem Sie den JSON-Code im Textfeld Geokodierungsservice aktualisiert haben, klicken Sie unten auf der Seite auf Organisation aktualisieren.

Die url des Locator-Service mit der hinzugefügten numBatchThreads-Eigenschaft sollte als geocodeServiceURL in den Tasks AnalyzeGeocodeInput und BatchGeocode verwendet werden. Weitere Informationen zum Ausführen der Werkzeuge im GeocodingTools-Service über ArcGIS-REST-API-Tasks finden Sie in der Dokumentation zur ArcGIS REST API.