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 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:
Aby otrzymywać informacje o opłatach, ustaw nowe pole tablicy
extraComputations
na"TOLLS"
.Aby otrzymywać zużycie paliwa, ustaw nowe pole tablicy
extraComputations
na"FUEL_CONSUMPTION"
.Aby otrzymywać informacje o ruchu na liniach łamanych, ustaw nowe pole tablicy
extraComputations
na"TRAFFIC_ON_POLYLINE"
.