Migracja z wersji przedpremierowej

Interfejs Routes API został wydany w ramach publicznej wersji przedpremierowej (wcześniejszej niż 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.

W tej sekcji opisaliśmy, jak przenieść aplikację z wersji w podglądzie do wersji ogólnodostępnej.

Dodano nowe funkcje 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, używając:

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

      Ciągi adresów to często sposób, w jaki użytkownik podaje adres. Jednak zanim {product_name} będzie mogło obliczyć trasę, musi najpierw wewnętrznie przetworzyć ciąg adresu na adresy szerokości i długości geograficznej.

      Dodano też obsługę parametru żądania regionCode, który umożliwia zwracanie wyników geokodowanych w przypadku określonego regionu geograficznego.

    • Plus Codes

      Kody Plus Code działają jak adresy dla osób lub miejsc, które nie mają adresu. Zamiast adresów z nazwami ulic i numerami kody plus opierają się na szerokości i długości geograficznej oraz są wyświetlane w postaci cyfr i liter.

  • Odpowiedź na żądanie obliczania tras zawiera teraz tablicę geocodingResults. W przypadku każdej lokalizacji w żądaniu (początku, miejsca docelowego lub pośredniego punktu kontrolnego), która została określona jako ciąg znaków adresu lub jako kod plus, interfejs API wykonuje wyszukiwanie identyfikatora miejsca. Każdy element tego tablic zawiera identyfikator miejsca odpowiadający lokalizacji wraz z dodatkowymi metadanymi dotyczącymi tej lokalizacji. Lokalizacje w żądaniu określone jako identyfikator miejsca lub współrzędne szerokości i długości geograficznej 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 w wersji wstępnej użyliśmy maski pola, aby określić, jakie informacje o tych funkcjach mają być zwracane w odpowiedzi. Musisz teraz:

  • Aby włączyć te funkcje, ustaw nowy parametr extraComputations w zapytaniach dotyczących tablic.
  • Ustaw maskę pola, aby określić, czy informacje mają być zwracane w odpowiedzi.

Co muszę wiedzieć?

Te pola nie będą już uwzględniane w odpowiedziach metody 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 metody computeRoutes, chyba że zostaną wyraźnie włączone za pomocą ustawienia 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 natężenia ruchu na łuku drogi, musisz ustawić nowe pole tablicy żądań extraComputations tak, aby zawierało co najmniej jedną z tych wartości: