Migracja z wersji przedpremierowej

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

We wrześniu 2022 r. udostępniliśmy interfejs Routes API w publicznej wersji przedpremierowej (przed GA). Oferty przed GA są objęte specjalnymi 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 przedpremierowej do wersji GA.

Nowe funkcje dodane w wersji GA

W wersji GA dodaliśmy te nowe funkcje, które nie były dostępne w wersji przedpremierowej:

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

    • ciągów adresów ("Chicago, IL" lub "Darwin, NT, Australia")

      Ciągi adresów 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.

    • kodów plus.

      Kody plus są jak adresy dla osób lub miejsc, które nie mają rzeczywistego adresu. Zamiast adresów z nazwami ulic i numerami kody plus opierają się na szerokości i długości geograficznej i są wyświetlane jako cyfry i litery.

  • Odpowiedź na żądanie obliczania tras zawiera teraz tablicę geocodingResults. W przypadku każdej lokalizacji w żądaniu (punkt początkowy, miejsce docelowe lub pośredni punkt na trasie), 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 dotyczące tej lokalizacji. Lokalizacje w żądaniu określone jako identyfikator miejsca lub współrzędne geograficzne są ignorowane.

Zmiany w istniejących funkcjach wersji przedpremierowej

Aby włączyć te funkcje w wersji GA, musisz teraz wyraźnie dodać do żądania nowe pole tablicy extraComputations:

W wersji przedpremierowej używasz maski pola, aby określić, że w odpowiedzi mają być zwracane informacje o tych funkcjach. Teraz musisz:

  • ustawić nowy parametr żądania tablicy extraComputations, aby włączyć te funkcje;
  • ustawić maskę pola, aby określić, że 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 drogowych).

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 drogowych),
  • routes.travelAdvisory.tollInfo(informacje o opłatach drogowych),
  • routes.travelAdvisory.fuelConsumptionMicroliters(zużycie paliwa),
  • routes.travelAdvisory.speedReadingIntervals(ruch na polilinii),
  • routes.legs.travelAdvisory.speedReadingIntervals(ruch na polilinii).

Co muszę zrobić?

Aby otrzymywać pola odpowiedzi dotyczące informacji o opłatach drogowych, zużycia paliwa lub ruchu na polilinii, musisz ustawić nowe pole tablicy żądania extraComputations, aby zawierało co najmniej jedną z tych wartości: