Migracja z wersji przedpremierowej

Interfejs Routes API został udostępniony jako publiczna wersja przedpremierowa we wrześniu 2022 r. Oferty przed GA podlegają Szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

W tej sekcji opisujemy, jak przenieść aplikację z wersji testowej do wersji ogólnodostępnej.

Nowe funkcje dodane do wersji GA

Wersja GA dodaje następujące nowe funkcje, które nie były dostępne w wersji testowej:

  • Oprócz identyfikatorów miejsc i współrzędnych geograficznych możesz teraz określić lokalizację w wersji Google Analytics, używając:

    • Ciągi tekstowe („Chicago, IL” lub „Darwin, NT, Australia”)

      Ciągi z adresem to często sposób, w jaki użytkownik wpisuje adres. Zanim usługa {product_name} będzie mogła jednak obliczyć trasę, musi najpierw przetworzyć geokodowanie ciągu znaków adresu, aby przekonwertować go na współrzędne szerokości i długości geograficznej.

      Oprócz tego dodaliśmy obsługę parametru żądania regionCode, która umożliwia zwrócenie wyników z kodowaniem geograficznym w przypadku konkretnego regionu geograficznego.

    • Kody Plus Code

      Kody Plus Code są jak adresy osób lub miejsc, które nie mają rzeczywistego adresu. Zamiast adresów wraz z nazwami i numerami ulic kody Plus Code są wyświetlane w postaci cyfr i liter na podstawie szerokości i długości geograficznej.

  • Odpowiedź na trasy obliczeniowe zawiera teraz tablicę geocodingResults. Dla każdej lokalizacji w żądaniu (początku, miejsca docelowego lub pośredniego punktu pośredniego), która została określona jako ciąg adresu lub jako kod plus, interfejs API wyszukuje identyfikator miejsca. Każdy element tej tablicy zawiera identyfikator miejsca odpowiadający lokalizacji oraz dodatkowe metadane na jej temat. Lokalizacje w żądaniu określone jako identyfikator miejsca lub współrzędne szerokości i długości geograficznej są ignorowane.

Zmiany w dotychczasowych funkcjach w wersji testowej

Musisz teraz jednoznacznie włączyć w Google Analytics te funkcje, dodając do żądania nową tablicę extraComputations:

W wersji testowej użyto maski pola do określenia zwracania informacji o tych funkcjach w odpowiedzi. Teraz musisz:

  • Ustaw nowy parametr żądania tablicy extraComputations, aby włączyć te funkcje.
  • Ustaw maskę pola, która będzie zwracać informacje w odpowiedzi.

Co muszę wiedzieć?

Te pola nie będą już uwzględniane w odpowiedziachcomputeRouteMatrix, chyba że zostaną jednoznacznie włączone przez ustawienie extraComputations:

  • travelAdvisory.tollInfo (opłata)

Te pola nie będą już uwzględniane w odpowiedziach ComputeRoutes, chyba że zostaną jednoznacznie włączone przez ustawienie extraComputations:

  • routes.legs.travelAdvisory.tollInfo(opłata)
  • routes.travelAdvisory.tollInfo(opłata)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Zużycie paliwa)
  • routes.travelAdvisory.speedReadingIntervals(natężenie ruchu na linii łamanej)
  • routes.legs.travelAdvisory.speedReadingIntervals(natężenie ruchu na linii łamanej)

Co muszę zrobić?

Aby otrzymywać pola odpowiedzi z informacjami o opłatach za przejazd, zużyciem paliwa lub ruchu na linii łamanej, musisz w nowym polu tablicy żądań (extraComputations) uwzględnić co najmniej jedną z tych wartości: