Migracja z wersji przedpremierowej

Interfejs Routes API został udostępniony jako publiczna wersja przedpremierowa (przed GA) we wrześniu 2022 r. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Z tej sekcji dowiesz się, jak przenieść aplikację z wersji testowej do wersji Google Analytics.

Nowe funkcje dodane do wersji Google Analytics

Wersja GA dodaje te nowe funkcje, które nie zostały uwzględnione w wersji testowej:

  • Oprócz identyfikatorów miejsc i współrzędnych szerokości i długości geograficznej możesz teraz określić lokalizację w wersji GA za pomocą:

    • Ciągi adresów („Chicago, IL” lub „Darwin, NT, Australia”)

      Ciąg adresu służy często do wpisania adresu przez użytkownika. Jednak zanim usługa {product_name} będzie mogła obliczyć trasę, musi najpierw przetworzyć dane geokodem ciągu adresu, aby przekształcić go na współrzędne geograficzne.

      Dodaliśmy też obsługę parametru żądania regionCode, który umożliwia zwrócenie wyników w formie kodów geograficznych z konkretnego regionu geograficznego.

    • Kody plus

      Kody Plus Code są jak adresy osób i miejsc, które nie mają ich faktycznego adresu. Zamiast adresów z nazwą ulicy i numerami, kody Plus Code opierają się na szerokości i długości geograficznej, a są wyświetlane jako cyfry i litery.

  • Odpowiedź dotycząca tras obliczeniowych zawiera teraz tablicę geocodingResults. W przypadku każdej lokalizacji w żądaniu (źródło, miejsce docelowe lub pośredni punkt na trasie), która została określona jako ciąg adresu lub w postaci kodu Plus, interfejs API wyszukuje identyfikator miejsca. Każdy element tej tablicy zawiera identyfikator miejsca odpowiadający lokalizacji wraz z dodatkowymi metadanymi na jej temat. Lokalizacje w żądaniu określone jako identyfikator miejsca lub jako współrzędne szerokości i długości geograficznej są ignorowane.

Zmiany w istniejących funkcjach w wersji testowej

Musisz teraz wyraźnie włączać te funkcje w Google Analytics, dodając do żądania nowe pole extraComputations w tablicy:

W wersji testowej użyto maski pól do określenia, czy w odpowiedzi będą zwracane informacje o tych funkcjach. Teraz musisz:

  • Ustaw nowy parametr żądania tablicy extraComputations, aby włączyć te funkcje.
  • Ustaw maskę pola, aby określić zwracanie informacji w odpowiedzi.

Co muszę wiedzieć?

Te pola nie będą już uwzględniane w odpowiedziachcomputeRouteMatrix, chyba że zostanie wyraźnie włączone ustawienie extraComputations:

  • travelAdvisory.tollInfo (informacje o opłatach)

Te pola nie będą już uwzględniane w odpowiedziachcomputeRoutes, chyba że włączysz je bezpośrednio w ustawieniu extraComputations:

  • routes.legs.travelAdvisory.tollInfo(informacje o opłatach)
  • routes.travelAdvisory.tollInfo(informacje o opłatach)
  • routes.travelAdvisory.fuelConsumptionMicroliters(zużycie paliwa)
  • routes.travelAdvisory.speedReadingIntervals(Ruch na linii łamanej)
  • routes.legs.travelAdvisory.speedReadingIntervals(Ruch na linii łamanej)

Co muszę zrobić?

Aby otrzymywać pola odpowiedzi dotyczące opłat, zużycia paliwa lub ruchu na linii łamanej, musisz ustawić nowe pole tablicy żądań (extraComputations) tak, aby zawierało co najmniej jedną z tych wartości: