Method: searchAlongRoute

wyszukiwać miejsca na trasie podróży,

Żądanie HTTP

POST https://mapstools.googleapis.com/v1alpha:searchAlongRoute

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
Pola
textQuery

string

Wymagane. Zapytanie w języku naturalnym (np. „ładowarki EV”, „kawa”).

languageCode

string

Opcjonalnie. Język podsumowania i informacji o miejscu. Domyślna wartość to „en-US”.

regionCode

string

Opcjonalnie. Kod kraju/regionu (CLDR) lokalizacji (np. „US”).

routingPreference

enum (RoutingPreference)

Opcjonalnie. Opcjonalne ustawienie routingu określające sposób wykorzystania danych o ruchu. Domyślna wartość to TRAFFIC_UNAWARE.

includeExtendedDetails

boolean

Opcjonalnie. Zawiera w odpowiedzi rozszerzone informacje o miejscu.

Ustaw to pole na true, gdy prośba użytkownika wymaga szczegółowych informacji jakościowych, dynamicznych danych w czasie rzeczywistym lub specjalistycznych atrybutów encji: – opinie jakościowe, nastroje klientów i opinie. - konkretne oferty, takie jak pozycje menu, dania, specjały, napoje lub najważniejsze informacje o firmie; – jakościowa atmosfera, wystrój wnętrza, estetyka, nastrój lub klimat; – Dane w czasie rzeczywistym i specjalistyczne informacje o placówkach, zasady i wskazówki dla odwiedzających, czasy oczekiwania.

Pozostaw false (domyślnie) w przypadku standardowych wyszukiwań (np. kuchni, typów sklepów), wyszukiwania lokalizacji/adresu, informacji kontaktowych, godzin otwarcia i standardowych metadanych/udogodnień.

Włączenie tego pola może spowodować większe opóźnienie.

travelMode

enum (RouteTravelMode)

Opcjonalnie. Określa środek transportu używany do obliczania trasy i objazdów. Domyślna wartość to DRIVE. Atrybuty WALK i BICYCLE są obsługiwane tylko w przypadku routeEndpoints. TRANSIT nie jest obsługiwany.

Specyfikacja trasy: istniejąca trasa, token trasy lub punkty końcowe miejsca początkowego i docelowego. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
encodedPolyline

string

Zakodowany ciąg znaków linii łamanej reprezentujący trasę. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/utilities/polylinealgorithm.

retrievalToken

string

Token pobierania zwrócony z poprzedniego wywołania v1alpha.computeRoutes reprezentującego trasę.

routeEndpoints

object (RouteEndpoints)

jawne punkty końcowe trasy (miejsce początkowe i docelowe);

Koniec pól wykluczających się wzajemnie.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu SearchAlongRouteResponse.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools