Skip To Content

Najważniejsze wskazówki dotyczące geokodowania wsadowego w portalu

Wymagania

Wdrożone oprogramowanie ArcGIS Enterprise pozwala korzystać ze wzorca asynchronicznego geokodowania wsadowego po stronie serwera, który pomoże uzyskać najlepszą możliwą wydajność z usług lokalizatorów. To podejście ma zastosowanie względem lokalizatorów opublikowanych w portalu i dodanych jako usługa narzędziowa. Więcej informacji o tworzeniu lokalizatorów, udostępnianiu ich w portalu i dodawaniu ich jako usługi narzędziowej zawiera temat Konfigurowanie portalu do obsługi geokodowania adresów.

Korzyści

Dzięki zaawansowanym możliwościom oprogramowania ArcGIS Enterprise możemy maksymalnie wykorzystać opublikowane usługi geokodowania. Po udostępnieniu lokalizatora w portalu można go użyć do geokodowania wsadowego. Niektóre korzyści płynące z użycia portalu do geokodowania wsadowego są następujące:

  • Maksymalizacja zasobów serwera w celu najszybszego możliwego przeprowadzenia zadania geokodowania.
  • Umożliwienie administratorowi ArcGIS zarządzania zasobami wewnętrznymi bez przeciążania usług.
  • Wykonywanie dużych operacji geokodowania wsadowego za zaporą instytucji z użyciem danych i własnego opublikowanego lokalizatora.
  • Wbudowana logika dzielenia na kawałki i ponawiania, dzięki czemu duże zadania geokodowania nie kończą się niepowodzeniem.

Architektura

Aby najlepiej wykorzystać opublikowane usługi lokalizatora, można wyskalować liczbę instancji serwera geokodowania. W tym celu można przejść do katalogu usług aplikacji ArcGIS Server Manager, wybrać usługę geokodowania do przeskalowania, przejść do karty Dostępność instancji i zmienić parametry Minimalna liczba instancji ma komputerze oraz Maksymalna liczba instancji ma komputerze. W przypadku geokodowania te liczby zawsze powinny być równe. Aby instancje były dostępne cały czas, można zmienić obie te wartości na 4.

Dodawanie właściwości numBatchThreads

Na powyższym schemacie administrator ArcGIS wyskalował usługę lokalizatora do czterech instancji. Administrator ArcGIS Twojej instytucji może następnie skonfigurować właściwość numBatchThreads na 4 dla lokalizatora i osiągnąć czterokrotne zwiększenie wydajności geokodowania wsadowego. Administrator może skonfigurować właściwość numBatchThreads w lokalizacji udostępniania Portal for ArcGIS Directory. Pamiętaj, że jeśli dwóch użytkowników chce jednocześnie wykonać geokodowanie wsadowe, administrator ArcGIS powinien skonfigurować właściwość numBatchThreads na wartość 2, ponieważ w przeciwnym razie zadania zostaną umieszczone w kolejce i być może nastąpi przekroczenie ich limitu czasu podczas oczekiwania na zakończenie innego zadania. W ten sposób każde zadanie geokodowania wsadowego zostanie uruchomione dla dwóch dostępnych instancji lokalizatora i wewnętrzne usługi lokalizatora będą w stanie obsłużyć obciążenie związane z jednoczesnym wprowadzeniem wielu zadań.

Konfiguracja

Poniżej opisano, w jaki sposób administrator ArcGIS może skonfigurować portal do wykorzystania opisanego powyżej wzorca geokodowania wsadowego.

Dodawanie rejestrowania, aby uzyskać więcej informacji zwrotnych podczas geokodowania wsadowego

Domyślnie poziom komunikatów usługi geoprzetwarzania GeocodingTools jest skonfigurowany na wartość Ostrzeżenie. Aby uzyskać bardziej szczegółowe komunikaty o błędach i lepsze aktualizacje statusu wsadowego zadania geokodowania, można skonfigurować poziom rejestrowania usługi geoprzetwarzania GeocodingTools na wartość Informacje.

  1. Przejdź do aplikacji ArcGIS Server Manager serwera hostującego.
  2. Kliknij folder Narzędzia w katalogu aplikacji Server Manager.
  3. Kliknij usługę geoprzetwarzania GeocodingTools.
  4. Kliknij baner Parametry po lewej stronie i zmień wartość Poziom komunikatu na Informacje. Następnie kliknij przycisk Zapisz i ponownie uruchom znajdujący się górnym prawym rogu.

Zmiana poziomu rejestrowania na Informacje spowoduje niewielki spadek wydajności, ale zapewni lepszą informację zwrotną o postępie zadania i więcej informacji o możliwych błędach, w przypadku ich wystąpienia. Te korzyści są widoczne w narzędziach Geokoduj tabelę, Geokoduj lokalizacje z tabeli oraz Geokoduj plik w aplikacji ArcGIS Pro.

Zwiększenie limitu czasu geokodowania wsadowego

Domyślnie przekroczenie limitu czasu w usłudze geoprzetwarzania GeocodingTools następuje w przypadku zadań wykonywanych dłużej niż 200 minut. Jeśli przewiduje się, że zadanie geoprzetwarzania wsadowego może potrwać dłużej niż 3 godziny i 20 minut, należy zwiększyć maksymalny czas, przez który aplikacja kliencka może korzystać z usługi.

  1. Przejdź do aplikacji ArcGIS Server Manager serwera hostującego.
  2. Kliknij folder Narzędzia w katalogu aplikacji Server Manager.
  3. Kliknij usługę geoprzetwarzania GeocodingTools.
  4. Kliknij baner Dostępność instancji po lewej stronie i zmień maksymalny czas, przez który aplikacja kliencka może korzystać z usługi. Zwiększenie tej wartości na bardzo dużą liczbę zapewni, że duże zadania geokodowania wsadowego nigdy nie przekroczą limitu czasu. Następnie kliknij przycisk Zapisz i ponownie uruchom znajdujący się górnym prawym rogu.

Konfigurowanie sugerowanej liczby jednoczesnych żądań geokodowania (numBatchThreads) dla lokalizatora

Lokalizator portalu może być również używany przez usługę geoprzetwarzania GeocodingTools działającą w sfederowanej witrynie GIS Server. Usługa geoprzetwarzania może wysłać wiele jednoczesnych żądań do usługi narzędziowej geokodowania, aby przyspieszyć łączne wykonywanie dla geokodowania wsadowego. Liczbę jednoczesnych żądań wysyłanych przez usługę geoprzetwarzania może skonfigurować administrator portalu. Jeśli usługa geoprzetwarzania wysyła za dużo jednoczesnych żądań do lokalizatora, może on słabo działać i może to spowodować więcej niepowodzeń przy uruchamianiu usługi geoprzetwarzania. Z tego powodu administrator powinien skonfigurować liczbę instancji używanych przez usługę geoprzetwarzania na podstawie liczby instancji dostępnych dla usługi lokalizatora, a także skonfigurować liczbę jednoczesnych żądań geokodowania wsadowego, które można wysłać z dowolnej instancji usługi geoprzetwarzania GeocodingTools.

Najważniejszą wskazówką jest, aby liczba instancji dla usługi lokalizatora zawsze była większa lub równa liczbie instancji dostępnych dla usługi geoprzetwarzania GeocodingTools. Liczbę jednoczesnych żądań geokodowania wsadowego należy skonfigurować proporcjonalnie do liczby instancji dostępnych zarówno dla lokalizatora, jak i usług geoprzetwarzania. Jeśli na przykład istnieje osiem instancji dostępnych dla usługi lokalizatora i dwie instancje dostępne dla usługi geoprzetwarzania, skonfiguruj liczbę jednoczesnych żądań geokodowania wsadowego na 4. Gdy będzie wykonywana usługa geoprzetwarzania, wyśle ona cztery jednoczesne żądania geokodowania wsadowego do usługi lokalizatora. W sytuacji, gdy dla usługi lokalizatora jest dostępnych więcej instancji, dostosuj odpowiednio liczbę jednoczesnych żądań geokodowania wsadowego, aby zmaksymalizować wykorzystanie instancji usługi lokalizatora.

Pamiętaj, że geokodera wsadowego Esri World Batch Geocoder nie można skonfigurować do użycia większej liczby jednoczesnych żądań. Następujące konfiguracje dotyczą wszystkich pozostałych opublikowanych usług lokalizatorów skonfigurowanych jako usługi narzędziowe.

Aby skonfigurować sugerowaną liczbę jednoczesnych żądań geokodowania dla usługi lokalizatora, wykonaj następujące czynności:

  1. Przejdź do lokalizacji udostępniania Portal for ArcGIS Directory i zaloguj się z uprawnieniami administratora. Adres URL ma format https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
  2. Przejdź do strony Strona główna > Portale > Własny.
  3. Na dole strony kliknij przycisk Aktualizuj.
  4. W polu tekstowym Usługa geokodowania widoczne będą usługi lokalizatorów, które są obecnie skonfigurowane w portalu. W przypadku usług umożliwiających geokodowanie wsadowe (są to usługi z właściwością batch ustawioną na wartość true) możesz skonfigurować sugerowaną liczbę jednoczesnych żądań geokodowania wsadowego. Wybierz usługę, którą chcesz skonfigurować z tą właściwością. Format JSON w polu tekstowym Usługa geokodowania będzie następujący:
    [{
            "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. Dodaj właściwość numBatchThreads do wszystkich usług lokalizatora, których chcesz używać z usługą geoprzetwarzania GeocodingTools. Aby skonfigurować wartość właściwości numBatchThreads, najpierw określ, jaką liczbę jednoczesnych żądań geokodowania wsadowego chcesz włączyć dla danej usługi lokalizatora, a następnie skonfiguruj tę właściwość dokładnie na tę liczbę. Pamiętaj, że aby skonfigurować właściwość numBatchThreads w usłudze lokalizatora, usługa musi mieć wartość batch ustawioną na true.

    W tym przykładzie liczba dozwolonych jednoczesnych żądań geokodowania wsadowego dla usługi narzędziowej Streetmap Premium USA Geocoder jest skonfigurowana na 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. Po zaktualizowaniu formatu JSON w polu tekstowym Usługa geokodowania kliknij przycisk Aktualizuj instytucję na dole strony.

Narzędzia włączone dla geokodowania wsadowego

Po skonfigurowaniu przez administratora ArcGIS właściwości numBatchThreads dla każdego lokalizatora użytkownicy mogą korzystać ze zwiększonej wydajności w swoich zadaniach geokodowania wsadowego. Narzędzia korzystające z tego zwiększenia wydajności to: Geokoduj tabelę, Geokoduj lokalizacje z tabeli oraz Geokoduj plik w aplikacji ArcGIS Pro, a także Geokoduj lokalizacje z tabeli w przeglądarce map Map Viewer.