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,
  "pageSize": integer,
  "pageToken": string,
  "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
(deprecated)

integer

Wycofane: użyj zasady pageSize.

Maksymalna liczba wyników na stronę, które mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż maxResultCount, zwracany jest parametr nextPageToken, który może zostać przekazany do pageToken w celu wyświetlenia następnej strony wyników w kolejnych żądaniach. Jeśli nie podasz wartości 0 lub nie podasz żadnej, stosowana będzie wartość domyślna, czyli 20. Maksymalna wartość to 20, a wartości powyżej 20 zostaną zmienione na 20. Wartości ujemne zwrócą błąd INVALID_ARGUMENT.

Jeśli podasz zarówno wartość maxResultCount, jak i pageSize, parametr maxResultCount będzie ignorowany.
pageSize

integer

Opcjonalnie. Maksymalna liczba wyników na stronę, które mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż pageSize, zwracany jest parametr nextPageToken, który może zostać przekazany do pageToken w celu wyświetlenia następnej strony wyników w kolejnych żądaniach. Jeśli nie podasz wartości 0 lub nie podasz żadnej, stosowana będzie wartość domyślna, czyli 20. Maksymalna wartość to 20, a wartości powyżej 20 zostaną ustawione na 20. Wartości ujemne zwrócą błąd INVALID_ARGUMENT.

Jeśli podasz zarówno wartość maxResultCount, jak i pageSize, parametr maxResultCount będzie ignorowany.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania TextSearch. Podaj je, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie parametry inne niż pageToken, pageSize i maxResultCount podane w TextSearch muszą być zgodne z początkowym wywołaniem, które podało token strony. W przeciwnym razie 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)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string
}
Pola
places[]

object (Place)

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

object (ContextualContent)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Lista treści kontekstowych, w której każdy wpis wiąże się z odpowiednim miejscem w tym samym indeksie w polu miejsc. Preferowane są treści, które dotyczą elementu textQuery w żądaniu. Jeśli treść kontekstowa jest niedostępna w jednym z miejsc, wróci do wyświetlenia treści niezwiązane z kontekstem. Będzie puste tylko wtedy, gdy treść jest niedostępna dla tego miejsca. Ta lista powinna zawierać tyle wpisów, co lista miejsc, jeśli jest wymagana.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli to pole zostanie pominięte lub puste, nie będzie dalszych stron.

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.

ContextualContent

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Treść związana z zapytaniem dotyczącym miejsca.

Zapis JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Pola
reviews[]

object (Review)

Lista opinii o tym miejscu powiązanych z zapytaniem o miejsce.
photos[]

object (Photo)

Informacje (w tym odniesienia) o zdjęciach tego miejsca, kontekstowe w odniesieniu do zapytania.
justifications[]

object (Justification)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

uzasadnienia dotyczące miejsca,

Uzasadnienie

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

uzasadnienia dotyczące miejsca, Uzasadnienie odpowiada na pytanie, dlaczego dane miejsce może zainteresować użytkownika.

Zapis JSON 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Pola

Pole sumy justification.

justification może być tylko jedną z tych wartości:
reviewJustification

object (ReviewJustification)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

ReviewJustification

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Uzasadnienia opinii użytkownika. Wyróżnia to sekcję opinii użytkownika, która może być dla niego interesująca. Jeśli na przykład zapytanie to „pizza z drewna”, w uzasadnieniu sprawdzenia zostanie wyróżniony tekst odpowiadający wyszukiwanemu hasłu.

Zapis JSON 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Pola
highlightedText

object (HighlightedText)
review

object (Review)

Recenzja, na podstawie której został wygenerowany zaznaczony tekst.

HighlightedText

Tekst wyróżniony przez uzasadnienie. Jest to podzbiór samej opinii. Dokładne słowo, które ma być zaznaczone, jest oznaczone za pomocą elementu SelectionedTextRange. W tekście może być kilka słów.

Zapis JSON 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Pola
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Lista zakresów zaznaczonego tekstu.

HighlightedTextRange

Zakres zaznaczonego tekstu.

Zapis JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Pola
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Uzasadnienia atrybutów BusinessAvailabilityAttributes. Pokazuje on atrybuty firmy, które mogą zainteresować użytkowników.

Zapis JSON 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Pola
takeout

boolean

jeśli miejsce oferuje dania na wynos.
delivery

boolean

Jeśli miejsce oferuje dostawę.
dineIn

boolean

Jeśli w hotelu można zjeść na miejscu