Method: searchText

Wyszukuj miejsca za pomocą zapytania tekstowego.

Żądanie HTTP

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

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,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Pola
textQuery

string

Wymagane. Zapytanie tekstowe.
languageCode

string

Opcjonalnie. Język, w którym ma zostać zwrócone podsumowanie. Jeśli kod języka nie zostanie określony lub nie zostanie rozpoznany, zostanie zwrócone podsumowanie z preferencją języka angielskiego.

Na przykład „pl” w przypadku języka polskiego.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcjonalnie. Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania informacji o miejscu, takich jak nazwa miejsca w danym regionie, jeśli jest dostępna. Parametr może wpływać na wyniki na podstawie obowiązujących przepisów.

Na przykład „PL” w przypadku Polski.

Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.
pageSize

integer

Opcjonalnie. Maksymalna liczba miejsc do zwrócenia (do 10). Usługa może zwrócić mniej niż ta wartość. Wartość domyślna to 5.

Jeśli poprosisz o więcej niż 5 miejsc, zostanie aktywowany poziom Pro, co spowoduje naliczenie wyższych kosztów i zwiększenie czasu oczekiwania.
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 podmiotu: – 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 spowoduje aktywowanie poziomu Pro i wyższe rozliczone koszty oraz większe opóźnienie.
locationBias

object (LocationBias)

Opcjonalny region, który ma być preferowany w wynikach wyszukiwania. Jeśli w polu textQuery podano dokładną lokalizację, zostanie ona użyta do ukierunkowania wyników wyszukiwania zamiast tego pola.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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