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)
  },
  "routingParameters": {
    object (RoutingParameters)
  },
  "searchAlongRouteParameters": {
    object (SearchAlongRouteParameters)
  },
  "includePureServiceAreaBusinesses": boolean
}
Pola
textQuery

string

Wymagane. Zapytanie tekstowe w wyszukiwaniu tekstowym.
languageCode

string

Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Jeśli kod języka nie jest określony lub nie jest rozpoznawany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku, przy czym preferowany jest język angielski, jeśli takie szczegóły istnieją.

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

string

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

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 porządkowania wyników w odpowiedzi.
includedType

string

Wybrany typ miejsca. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługuje tylko jeden typ.
openNow

boolean

Służy do ograniczenia wyszukiwania do miejsc, które są obecnie otwarte. Wartość domyślna to fałsz.
minRating

number

Wyklucz wyniki, których średnia ocena użytkowników jest wyraźnie niższa od tego limitu. Prawidłowa wartość musi być liczbą zmiennoprzecinkową z zakresu od 0 do 5 (włącznie) z kadencem 0,5 zapisanym w postaci [0, 0,5, 1,0, …, 5,0]. Podana ocena zostanie zaokrąglona w górę do najbliższej 0,5(do góry). Na przykład ocena 0,6 spowoduje wyeliminowanie wszystkich wyników z oceną niższą niż 1,0.
maxResultCount
(deprecated)

integer

Wycofane: użyj w zastępstwie 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 nextPageToken, który można przekazać do pageToken, aby uzyskać następną stronę wyników w kolejnych żądaniach. Jeśli nie podasz żadnej wartości lub podasz wartość 0, zostanie użyta wartość domyślna 20. Maksymalna wartość to 20; wartości powyżej 20 zostaną sformatowane na 20. Wartości ujemne zwracają błąd INVALID_ARGUMENT.

Jeśli podana jest zarówno wartość maxResultCount, jak i pageSize, ta druga wartość jest ignorowana.maxResultCount
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 nextPageToken, który można przekazać do pageToken, aby uzyskać następną stronę wyników w kolejnych żądaniach. Jeśli nie podasz żadnej wartości lub podasz wartość 0, zostanie użyta wartość domyślna 20. Maksymalna wartość to 20. Wartości powyżej 20 zostaną ustawione na 20. Wartości ujemne zwracają błąd INVALID_ARGUMENT.

Jeśli podana jest zarówno wartość maxResultCount, jak i pageSize, ta druga wartość jest ignorowana.maxResultCount
pageToken

string

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

Podczas podziału na strony wszystkie parametry inne niż pageToken, pageSize i maxResultCount przekazane do TextSearch muszą być zgodne z pierwotnym wywołaniem, które dostarczyło token strony. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.
priceLevels[]

enum (PriceLevel)

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

boolean

Służy do ustawiania ścisłego filtrowania typu dla atrybutu includedType. Jeśli ma wartość Prawda, zwracane są tylko wyniki tego samego typu. Wartość domyślna to fałsz.
locationBias

object (LocationBias)

Region wyszukiwania. Ta lokalizacja służy jako preferencja, co oznacza, że mogą zostać zwrócone wyniki z okolic tej lokalizacji. Nie można go ustawić razem z parametrem locationRestriction.
locationRestriction

object (LocationRestriction)

Region wyszukiwania. Ta lokalizacja służy jako ograniczenie, co oznacza, że wyniki spoza danej lokalizacji nie zostaną zwrócone. Nie można go ustawić razem z parametrem locationBias.
evOptions

object (EVOptions)

Opcjonalnie: Ustaw opcje wyszukiwania EV w prośbie o wyszukiwanie miejsca.
routingParameters

object (RoutingParameters)

Opcjonalnie: dodatkowe parametry do kierowania na wyniki;
searchAlongRouteParameters

object (SearchAlongRouteParameters)

Opcjonalnie: dodatkowe parametry proto do wyszukiwania na trasie;
includePureServiceAreaBusinesses

boolean

Opcjonalnie: Uwzględnij firmy działające tylko na określonym obszarze, jeśli pole zawiera wartość true. Firma działająca na określonym obszarze to firma, która świadczy usługi na miejscu u klienta lub samodzielnie dostarcza produkty odbiorcom, ale nie obsługuje klientów pod swoim adresem. Mogą to być hydraulicy lub firmy świadczące usługi sprzątania. Firmy te nie mają adresu fizycznego ani lokalizacji w Mapach Google. W przypadku tych firm Places nie zwróci pól location, plusCode ani innych pól związanych z lokalizacją.

Treść odpowiedzi

Protokół odpowiedzi dla places.searchText.

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

Zapis JSON 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string,
  "searchUri": string
}
Pola
places[]

object (Place)

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

object (RoutingSummary)

Lista podsumowań tras, w której każdy wpis jest powiązany z odpowiednim miejscem w tym samym indeksie w polu places. Jeśli podsumowanie trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Ta lista będzie zawierać tyle pozycji, ile jest w liście miejsc (jeśli została podana).
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 jest powiązany z odpowiednim miejscem w tym samym indeksie w polu miejsc. Preferowane są treści, które są istotne dla textQuery w ramach żądania. Jeśli treści kontekstowe nie są dostępne w przypadku jednego z miejsc, zwrócą treści niekontekstualne. Będzie pusty tylko wtedy, gdy treści nie są dostępne dla tego miejsca. Ta lista będzie zawierać tyle pozycji, ile jest w liście miejsc (jeśli została podana).
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole lub pozostawisz je puste, nie będzie kolejnych stron.
searchUri

string

Link umożliwia użytkownikowi wyszukiwanie za pomocą tego samego zapytania tekstowego, które zostało określone w żądaniu w Mapach Google.

RankPreference

sposób porządkowania wyników w odpowiedzi.

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED W przypadku zapytania dotyczącego kategorii, np. „Restauracje w Nowym Jorku”, domyślnie jest używana trafność. W przypadku zapytań niebędących zapytaniami o kategorię, np. „Warszawa, Polska”, zalecamy pozostawienie niewybranego ustawienia preferencji rankingu.
DISTANCE Ustawia wyniki według odległości.
RELEVANCE Wyniki są sortowane według trafności. kolejność sortowania określona na podstawie normalnego zbioru rankingów;

LocationBias

Region wyszukiwania. Ta lokalizacja służy jako preferencja, co oznacza, że mogą zostać zwrócone wyniki z okolic tej lokalizacji.

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 unii type.

type może być tylko jednym z tych elementów:
rectangle

object (Viewport)

Prostokąt określony przez narożniki północno-wschodni i południowo-zachodni. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widoku. rectangle.low() musi być punktem południowo-zachodnim prostokątnego obszaru widoku. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widok prostokątny nie może być szerszy niż 180 stopni.
circle

object (Circle)

Okrąg zdefiniowany przez punkt środkowy i promień.

LocationRestriction

Region wyszukiwania. Ta lokalizacja służy jako ograniczenie, co oznacza, że wyniki spoza danej lokalizacji nie zostaną zwrócone.

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 unii type.

type może być tylko jednym z tych elementów:
rectangle

object (Viewport)

Prostokąt określony przez narożniki północno-wschodni i południowo-zachodni. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widoku. rectangle.low() musi być punktem południowo-zachodnim prostokątnego obszaru widoku. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widok prostokątny nie może być szerszy niż 180 stopni.

EVOptions

Opcje wyszukiwania EV w prośbie o wyszukiwanie miejsc.

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

number

Opcjonalnie: Minimalna wymagana szybkość ładowania w kilowatach. Miejsce z niższą stawką niż określona zostaje odfiltrowane.
connectorTypes[]

enum (EVConnectorType)

Opcjonalnie: Lista preferowanych typów złączy EV. Miejsce, które nie obsługuje żadnego z wymienionych typów łączników, zostanie odfiltrowane.

SearchAlongRouteParameters

Określa wstępnie obliczony poligon z interfejsu Routes API, który definiuje trasę do wyszukania. Wyszukiwanie wzdłuż trasy jest podobne do korzystania z opcji locationBias lub locationRestriction, aby wpływać na wyniki wyszukiwania. Opcje locationBias i locationRestriction umożliwiają określenie regionu, w którym mają być wyświetlane wyniki wyszukiwania, ale ta opcja pozwala na wyświetlanie wyników na trasie podróży.

Wyniki nie muszą być zlokalizowane wzdłuż podanej trasy, ale są one sortowane w obszarze wyszukiwania zdefiniowanym przez polilinię i opcjonalnie przez locationBias lub locationRestriction na podstawie minimalnego czasu objazdu od punktu początkowego do docelowego. Wyniki mogą być podane dla trasy alternatywnej, zwłaszcza jeśli podana linia wielokąta nie określa optymalnej trasy od punktu początkowego do docelowego.

Zapis JSON 
{
  "polyline": {
    object (Polyline)
  }
}
Pola
polyline

object (Polyline)

Wymagane. Linia łamana trasy.

Linia łamana

Linia łamana trasy. Obsługuje tylko zakodowaną wielolinię, która może być przekazywana jako ciąg znaków i zawiera kompresję z minimalną utratą jakości. To jest domyślny wynik interfejsu Routes API.

Zapis JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string
  // End of list of possible types for union field polyline_type.
}
Pola
Pole unii polyline_type. Zawiera typ linii złożonej. Domyślne dane wyjściowe interfejsu Routes API to encoded_polyline. polyline_type może być tylko jednym z tych elementów:
encodedPolyline

string

Zakodowana linia łamana zwrócona domyślnie przez interfejs API Trasy. Zapoznaj się z narzędziami kodowania i dekodowania.

ContextualContent

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

Treści kontekstowe związane z zapytaniem o miejsce.

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

object (Review)

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

object (Photo)

Informacje (w tym odniesienia) o zdjęciach tego miejsca, kontekstowe w związku z zapytaniem o miejsce.
justifications[]

object (Justification)

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

uzasadnienie dotyczące miejsca;

Uzasadnienie

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

uzasadnienie dotyczące miejsca; Uzasadnienia odpowiadają 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 unii justification.

justification może być tylko jednym z tych elementów:
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żytkowników. To wyróżnia sekcję opinii użytkownika, która może zainteresować użytkownika końcowego. Jeśli na przykład wyszukiwane hasło to „pizza z drewna opałowego”, uzasadnienie opinii wyróżnia tekst odnoszący się do wyszukiwanego hasła.

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

object (HighlightedText)
review

object (Review)

Opinia, na podstawie której wygenerowano podświetlony tekst.

HighlightedText

Tekst wyróżniony przez uzasadnienie. Jest to podzbiór samego sprawdzenia. Dokładne słowo do wyróżnienia jest oznaczone za pomocą atrybutu HighlightedTextRange. W tekście może być kilka wyróżnionych słów.

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

Lista zakresów zaznaczonego tekstu.

HighlightedTextRange

Zakres wyróżnionego 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 ona atrybuty firmy, które mogą zainteresować użytkownika końcowego.

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

boolean

czy miejsce oferuje jedzenie na wynos.
delivery

boolean

czy miejsce oferuje dostawę.
dineIn

boolean

czy w danym miejscu można zjeść posiłek;