Method: places.searchText

Wyszukiwanie miejsc na podstawie zapytania tekstowego.

Żądanie HTTP

POST https://places.googleapis.com/v1/places: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,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Pola
textQuery

string

Wymagane. Zapytanie tekstowe do wyszukiwania tekstowego.
languageCode

string

Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Jeśli kod języka jest nieokreślony lub nierozpoznany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku (preferowane są język angielski, jeśli takie informacje istnieją).

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

string

Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa.

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.
rankPreference

enum (RankPreference)

sposób ustalania kolejności wyników w odpowiedzi;
includedType

string

Żądany typ miejsca. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługują tylko jeden uwzględniony typ.
openNow

boolean

Służy do ograniczenia wyszukiwania do obecnie otwartych miejsc. Wartość domyślna to false (fałsz).
minRating

number

Odfiltrowuje wyniki, których średnia ocena użytkowników jest wyraźnie niższa od tego limitu. Prawidłowa wartość musi być liczbą zmiennoprzecinkową między 0 a 5 (włącznie) z częstotliwością 0,5, tj. [0, 0,5; 1,0; ... , 5,0] włącznie. Ocena danych wejściowych zostanie zaokrąglona w górę do najbliższej wielokrotności 0,5(skala). Na przykład ocena 0,6 eliminuje wszystkie wyniki z oceną mniejszą niż 1,0.
maxResultCount

integer

Maksymalna liczba wyników do zwrócenia. Wartość ta musi mieścić się w przedziale od 1 do 20. Wartość domyślna to 20. Jeśli wartość jest nieskonfigurowana, wraca do górnego limitu. Jeśli liczba jest ustawiona na ujemną lub przekracza górny limit, zwracany jest błąd INVALID_ARGUMENT.
priceLevels[]

enum (PriceLevel)

Służy do ograniczenia wyszukiwania do miejsc oznaczonych jako określone poziomy cen. Użytkownicy mogą wybrać dowolne kombinacje poziomów cen. Domyślnie wybierz wszystkie poziomy cen.
strictTypeFiltering

boolean

Służy do ustawiania rygorystycznego filtrowania typów dla uwzględnionych typów. Jeśli zasada ma wartość Prawda, zwracane są tylko wyniki tego samego typu. Wartość domyślna to fałsz.
locationBias

object (LocationBias)

Region do przeszukania. Lokalizacja jest odchyleniem, co oznacza, że mogą być zwracane wyniki dotyczące jej okolicy. Tego ustawienia nie można ustawić razem z ograniczeniem lokalizacji.
locationRestriction

object (LocationRestriction)

Region do przeszukania. Ta lokalizacja jest ograniczeniem, co oznacza, że wyniki spoza danej lokalizacji nie będą zwracane. Tego ustawienia nie można ustawić razem z locationBias.
evOptions

object (EVOptions)

Opcjonalnie. Ustaw opcje EV z możliwością wyszukiwania w żądaniu wyszukiwania miejsc.

Treść odpowiedzi

Odpowiedź proto dotycząca miejsca places.searchText.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "places": [
    {
      object (Place)
    }
  ]
}
Pola
places[]

object (Place)

Lista miejsc, które spełniają kryteria wyszukiwania tekstowego użytkownika.

RankPreference

sposób ustalania kolejności wyników w odpowiedzi;

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED W przypadku zapytania kategorialnego, takiego jak „Restauracje w Krakowie”, domyślna wartość to RELEVANCE. W przypadku zapytań niedotyczących kategorii, takich jak „Mountain View, CA”, zalecamy pozostawienie nieskonfigurowanej pozycji rankingPreference.
DISTANCE Ranking wyników według odległości.
RELEVANCE Ranking wyników według trafności. Kolejność sortowania jest określana przez normalny stos rankingowy.

LocationBias

Region do przeszukania. Lokalizacja jest odchyleniem, co oznacza, że mogą być zwracane wyniki dotyczące jej okolicy.

Zapis JSON 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Pola

Pole sumy type.

type może być tylko jedną z tych wartości:
rectangle

object (Viewport)

Prostokątny prostokąt wyznaczony przez północno-wschodni róg. rectangle.high() musi być północno-wschodnim punktem widocznego obszaru prostokąta. rectangle.low() musi być południowo-zachodnim punktem widocznego obszaru w prostokącie. Wartość w polu rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widoczny obszar prostokątny nie może być szerszy niż 180 stopni.
circle

object (Circle)

Okrąg określony przez punkt środkowy i promień.

LocationRestriction

Region do przeszukania. Ta lokalizacja jest ograniczeniem, co oznacza, że wyniki spoza danej lokalizacji nie będą zwracane.

Zapis JSON 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Pola

Pole sumy type.

type może być tylko jedną z tych wartości:
rectangle

object (Viewport)

Prostokątny prostokąt wyznaczony przez północno-wschodni róg. rectangle.high() musi być północno-wschodnim punktem widocznego obszaru prostokąta. rectangle.low() musi być południowo-zachodnim punktem widocznego obszaru w prostokącie. Wartość w polu rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widoczny obszar prostokątny nie może być szerszy niż 180 stopni.

EVOptions

Opcje EV z możliwością wyszukiwania w ramach żądania wyszukiwania miejsca.

Zapis JSON 
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Pola
minimumChargingRateKw

number

Opcjonalnie. Minimalna wymagana szybkość ładowania w kilowatach. Miejsca, w których szybkość ładowania jest niższa niż określona, zostanie odfiltrowana.
connectorTypes[]

enum (EVConnectorType)

Opcjonalnie. Lista preferowanych typów złączy EV. Miejsce, które nie obsługuje żadnego z wymienionych typów oprogramowania sprzęgającego, zostanie odfiltrowane.