Migracja z wersji przedpremierowej

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Interfejs Routes API został udostępniony w wersji testowej (przed GA) we wrześniu 2022 r. Oferty przed GA są objęte Warunkami korzystania z usług Google Maps Platform. Więcej informacji znajdziesz w opisach etapów wprowadzania.

Z tej sekcji dowiesz się, jak przenieść aplikację z wersji w wersji zapoznawczej do wersji ogólnodostępnej.

Nowe funkcje dodane w wersji ogólnodostępnej

Wersja GA zawiera te nowe funkcje, których nie było w wersji podglądowej:

  • 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} 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 konkretnego regionu geograficznego.

    • Kody Plus

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

  • Odpowiedź interfejsu Compute Routes zawiera teraz tablicę geocodingResults. W przypadku każdej lokalizacji w żądaniu (punkt początkowy, miejsce docelowe lub punkt pośredni), która została określona jako ciąg znaków adresu lub kod plus, interfejs API wyszukuje identyfikator miejsca. Każdy element tej tablicy zawiera identyfikator miejsca odpowiadający lokalizacji wraz z dodatkowymi metadanymi dotyczącymi lokalizacji. Lokalizacje w żądaniu określone jako identyfikator miejsca lub współrzędne geograficzne są ignorowane.

Zmiany w istniejących funkcjach w wersji przedpremierowej

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

W wersji przedpremierowej do określania, które informacje o tych funkcjach mają być zwracane w odpowiedzi, używano maski pola. Teraz musisz:

  • 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 polilinii, musisz ustawić nowe pole tablicy żądań extraComputations tak, aby zawierało co najmniej 1 z tych wartości: