- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- Uzasadnienie
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
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 ( |
Pola | |
---|---|
textQuery |
Wymagane. Zapytanie tekstowe do wyszukiwania tekstowego. |
languageCode |
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 |
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 |
sposób ustalania kolejności wyników w odpowiedzi; |
includedType |
Żą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 |
Służy do ograniczenia wyszukiwania do obecnie otwartych miejsc. Wartość domyślna to false (fałsz). |
minRating |
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 |
Wycofane: użyj zasady Maksymalna liczba wyników na stronę, które mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż Jeśli podasz zarówno wartość |
pageSize |
Opcjonalnie. Maksymalna liczba wyników na stronę, które mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż Jeśli podasz zarówno wartość |
pageToken |
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania TextSearch. Podaj je, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie parametry inne niż |
priceLevels[] |
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 |
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 |
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 |
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 |
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 ( |
Pola | |
---|---|
places[] |
Lista miejsc, które spełniają kryteria wyszukiwania tekstowego użytkownika. |
contextualContents[] |
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 |
nextPageToken |
Token, który można wysłać jako |
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 |
Pola | |
---|---|
Pole sumy
|
|
rectangle |
Prostokątny prostokąt wyznaczony przez północno-wschodni róg. |
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 |
Pola | |
---|---|
Pole sumy
|
|
rectangle |
Prostokątny prostokąt wyznaczony przez północno-wschodni róg. |
EVOptions
Opcje EV z możliwością wyszukiwania w ramach żądania wyszukiwania miejsca.
Zapis JSON |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Pola | |
---|---|
minimumChargingRateKw |
Opcjonalnie. Minimalna wymagana szybkość ładowania w kilowatach. Miejsca, w których szybkość ładowania jest niższa niż określona, zostanie odfiltrowana. |
connectorTypes[] |
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 ( |
Pola | |
---|---|
reviews[] |
Lista opinii o tym miejscu powiązanych z zapytaniem o miejsce. |
photos[] |
Informacje (w tym odniesienia) o zdjęciach tego miejsca, kontekstowe w odniesieniu do zapytania. |
justifications[] |
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 |
Pola | |
---|---|
Pole sumy
|
|
reviewJustification |
Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
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 ( |
Pola | |
---|---|
highlightedText |
|
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 ( |
Pola | |
---|---|
text |
|
highlightedTextRanges[] |
Lista zakresów zaznaczonego tekstu. |
HighlightedTextRange
Zakres zaznaczonego tekstu.
Zapis JSON |
---|
{ "startIndex": integer, "endIndex": integer } |
Pola | |
---|---|
startIndex |
|
endIndex |
|
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 |
jeśli miejsce oferuje dania na wynos. |
delivery |
Jeśli miejsce oferuje dostawę. |
dineIn |
Jeśli w hotelu można zjeść na miejscu |