Migracja z wersji przedpremierowej

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Interfejs Routes API został udostępniony w publicznej wersji przedpremierowej (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 w wersji zapoznawczej do wersji ogólnodostępnej.

Nowe funkcje dodane do wersji GA

Wersja GA zawiera te nowe funkcje, które nie były dostępne w wersji Preview:

  • Oprócz identyfikatorów miejsc i współrzędnych geograficznych możesz teraz określać lokalizację w wersji GA za pomocą:

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

      Ciągi znaków adresu to często sposób, w jaki użytkownik wpisuje adres. Zanim jednak {product_name} będzie mogła obliczyć trasę, musi najpierw wewnętrznie geokodować ciąg adresu, aby przekształcić go we współrzędne geograficzne.

      Dodaliśmy też obsługę parametru żądania regionCode, który umożliwia określenie, że mają być zwracane wyniki geokodowania dla określonego regionu geograficznego.

    • Kody Plus

      Kody Plus Code są podobne do adresów ulic dla osób lub miejsc, które nie mają rzeczywistego adresu. Kody Plus Code nie są oparte na adresach z nazwami ulic i numerami budynków, ale na szerokości i długości geograficznej. Wyświetlają się jako ciągi cyfr i liter.

  • Odpowiedź na żądanie obliczenia tras zawiera teraz tablicę geocodingResults. W przypadku każdej lokalizacji w żądaniu (punktu początkowego, miejsca docelowego lub punktu pośredniego), która została określona jako ciąg znaków adresu lub Plus Code, interfejs API wyszukuje identyfikator miejsca. Każdy element tej tablicy zawiera identyfikator miejsca odpowiadający lokalizacji oraz dodatkowe metadane dotyczące tej lokalizacji. Lokalizacje w żądaniu określone jako identyfikator miejsca lub współrzędne geograficzne są ignorowane.

Zmiany w istniejących funkcjach w wersji testowej

Teraz musisz wyraźnie włączyć te funkcje w GA, dodając do żądania nowe pole tablicy extraComputations:

W wersji testowej użyto maski pola, aby określić, że w odpowiedzi mają być zwracane informacje o tych funkcjach. Teraz musisz wykonać obie te czynności:

  • Aby włączyć te funkcje, ustaw nowy parametr żądania tablicy extraComputations.
  • Ustaw maskę pola, aby określić, które informacje mają być zwracane w odpowiedzi.

Co muszę wiedzieć?

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

  • travelAdvisory.tollInfo (Informacje o opłatach)

Te pola nie będą już uwzględniane w odpowiedziach computeRoutes, chyba że zostaną wyraźnie włączone przez ustawienie 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 otrzymać pola odpowiedzi dotyczące informacji o opłatach, zużyciu paliwa lub ruchu na linii łamanej, musisz ustawić nowe pole tablicy żądań extraComputations tak, aby zawierało co najmniej jedną z tych wartości: