Wyszukiwanie tekstowe (nowość) zwraca informacje o zestawie miejsc na podstawie ciągu znaków, np. „pizza w Warszawie” lub „sklep obuwniczy w pobliżu Ottawy” lub „ulica Główna 123”. usługa wysyła w odpowiedzi listę miejsc pasujących do ciągu tekstowego i dowolną lokalizację uprzedzenia.
Usługa jest szczególnie przydatna do tworzenia niejednoznacznych zapytań dotyczących adresów, w zautomatyzowanym systemie, komponenty ciągu niebędące adresem mogą być identyczne firmy i adresy. Przykłady niejednoznacznych zapytań dotyczących adresu: źle sformatowane adresy lub żądania zawierające składniki niezawierające adresu, takie jak jako nazwy firm. Żądania podobne do 2 pierwszych przykładów w poniższej tabeli może zwrócić zero wyników, chyba że dana lokalizacja – taka jak region, lokalizacja ograniczenie czy efekt przesunięcia w zależności od lokalizacji.
„ul. Główna 10, Wielka Brytania” lub „ul. Główna 123, USA” | wiele numerów „High Street” w Wielkiej Brytanii; przy „Main Street” w USA. Zapytanie nie zwraca pożądanych wyników, chyba że jest ograniczenie lokalizacji ustawiony. |
„Restauracja sieciowa Warszawa” | Wiele „Sieć Restauracja” lokalizacje w Nowym Jorku; brak adresu lub nawet nazwę ulicy. |
„ul. Rybaki 10, Warszawa” lub „123 Main Street, Pleasanton PL” | Tylko jedna „ulica główna” w mieście Escher w Wielkiej Brytanii; tylko jedna „ulica Główna” w amerykańskim mieście Pleasanton, Kalifornia. |
„UniqueRestaurantName Warszawa” | tylko jeden obiekt o takiej nazwie w Nowym Jorku; brak adresu które są niezbędne do rozróżniania. |
„pizzerie w Warszawie” | Zapytanie zawiera ograniczenie lokalizacji i „pizzerie”. to precyzyjnie zdefiniowany typ miejsca. Zwraca wiele wyników. |
„+1 514-670-8700” | To zapytanie zawiera numer telefonu. Zwraca wiele wyników dla: miejsc powiązanych z tym numerem telefonu. |
API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API Opcje interfejsu API:
Żądania wyszukiwania tekstowego
Żądanie wyszukiwania tekstowego to żądanie HTTP POST, które ma następujący format:
https://places.googleapis.com/v1/places:searchText
Przekazuj wszystkie parametry w treści żądania JSON lub w nagłówkach jako część żądanie POST. Na przykład:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Odpowiedzi na wyszukiwanie tekstowe (nowe)
Wyszukiwanie tekstowe (nowość) zwraca błąd Obiekt JSON jako odpowiedź. W odpowiedzi:
- Tablica
places
zawiera wszystkie pasujące miejsca. - Każde miejsce w tablicy jest reprezentowane przez
Place
obiektu. ObiektPlace
zawiera szczegółowe informacje o jednym miejsce. - Wartość FieldMask przekazana w żądaniu określa parametr
lista pól zwróconych w obiekcie
Place
.
Pełny obiekt JSON ma następujący format:
{ "places": [ { object (Place) } ] }
Wymagane parametry
-
FieldMask
Określ listę pól, które mają być zwracane w odpowiedzi, tworząc maską pola odpowiedzi. Przekaż maskę pola odpowiedzi do metody, używając parametru adresu URL
$fields
lubfields
albo za pomocą nagłówka HTTPX-Goog-FieldMask
Odpowiedź nie zawiera domyślnej listy zwróconych pól. Jeśli pominiesz maskę pola, metoda zwróci błąd.Dobrą metodą projektowania jest maskowanie pól, dzięki którym zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania opłaty rozliczeniowe.
Podaj oddzieloną przecinkami listę typów danych miejsc do zwrócenia. Przykład: aby pobrać wyświetlaną nazwę i adres miejsca.
X-Goog-FieldMask: places.displayName,places.formattedAddress
Użyj
*
, aby pobrać wszystkie pola.X-Goog-FieldMask: *
Wypełnij co najmniej jedno z tych pól:
Następujące pola aktywują kod SKU wyszukiwania tekstowego (tylko identyfikator):
places.attributions
,places.id
,places.name
*,nextPageToken
* Poleplaces.name
zawiera nazwę zasobu miejsca w formacie:places/PLACE_ID
. Użyj formatu:places.displayName
aby uzyskać dostęp do tekstowej nazwy miejsca.Te pola aktywują kod SKU wyszukiwania tekstowego (podstawowego):
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
Te pola aktywują kod SKU wyszukiwania tekstowego (zaawansowane):
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
Te pola aktywują kod SKU wyszukiwania tekstowego (preferowany):
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.servesBeer
,places.servesBreakfast
,places.servesBrunch
,places.servesCocktails
,places.servesCoffee
,places.servesDessert
,places.servesDinner
,places.servesLunch
,places.servesVegetarianFood
,places.servesWine
,places.takeout
-
textQuery
Ciąg tekstowy, który ma zostać wyszukany, na przykład: „restauracja”, „ul. Główna 123” lub „najlepsze miejsce, które warto zwiedzić we Wrocławiu”. Interfejs API zwraca dopasowania kandydatów na podstawie na podstawie tego ciągu i porządkuje wyniki na podstawie ich postrzeganej trafności.
Parametry opcjonalne
includedType
Ogranicza wyniki do miejsc pasujących do określonego typu zdefiniowanego przez Tabela A. Można podać tylko jeden typ. Na przykład:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
Język, w którym mają być zwracane wyniki.
- Zobacz listę obsługiwanych języków. Google często aktualizuje obsługiwane języki, więc ta lista może nie być jest wyczerpująca.
-
Jeśli nie podano
languageCode
, domyślnie używany jest interfejs APIen
Jeśli podasz nieprawidłowy kod języka, interfejs API zwraca błądINVALID_ARGUMENT
. - Robimy wszystko, co w naszej mocy, aby podać adres, który będzie czytelny dla zarówno użytkownika, jak i lokalnego użytkownika. Aby osiągnąć ten cel, adresów w języku lokalnym, transliterowanych na zapis czytelny dla w razie potrzeby, obserwując preferowany język. Wszystkie pozostałe są zwracane w preferowanym języku. Komponenty adresu są wszystkie zwrócone w tym samym języku, który jest wybierany spośród pierwszych .
- Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API używa atrybutu jak najbardziej zbliżona do siebie.
- Preferowany język ma niewielki wpływ na zestaw wyników, które zwracany przez interfejs API i kolejność ich zwrócenia. geokoder różnie interpretuje skróty w zależności od języka, np. skrótów typów ulic lub synonimów, które mogą być mogą być prawidłowe w jednym języku, a w innym już nie.
locationBias
Określa obszar wyszukiwania. Ta lokalizacja działa dyskryminująco, co oznacza, że wyniki dotyczące określonej lokalizacji, w tym wyniki poza określonym obszarem.
Możesz wybrać
locationRestriction
lublocationBias
, ale nie w obu przypadkach. ElementlocationRestriction
określa parametr regionu, w którym muszą się znajdować wyniki, orazlocationBias
jako określenie regionu, w którym wyniki muszą znajdować się w pobliżu, ale mogą się znajdować poza regionem. w pobliżu.Określ region jako prostokątny widoczny lub okrągły obszar.
Okrąg jest wyznaczany przez punkt środkowy i promień w metrach. Promień musi mieścić się w zakresie od 0,0 do 50 000,0 włącznie. Domyślny promień to 0,0. Na przykład:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Prostokąt to widoczny obszar o długości i szerokości szerokości geograficznej, reprezentowany przez dwa elementy. na przekątnej i na przekątnej. Najniższy punkt wskazuje południowy zachód róg prostokąta, a najwyższy punkt reprezentuje północny wschód w prawym górnym rogu prostokąta.
Widoczny obszar jest uważany za obszar zamknięty, co oznacza, że obejmuje jego granicę. Granice szerokości geograficznej musi mieścić się w przedziale od -90 do 90 stopni włącznie i musi mieścić się w granicach długości geograficznej musi mieścić się w zakresie od -180 do 180 stopni włącznie:
- Jeśli
low
=high
, widoczny obszar składa się z: ten pojedynczy punkt. - Jeśli
low.longitude
>high.longitude
, zakres długości geograficznej jest odwrócony (widoczny obszar przecina 180 stopni linii długości geograficznej). - Jeśli
low.longitude
= -180 stopni ihigh.longitude
= 180 stopni, widoczny obszar obejmuje wszystkie długości geograficznej. - Jeśli
low.longitude
= 180 stopni ihigh.longitude
= -180 stopni, zakres długości geograficznej to puste. - Jeśli
low.latitude
>high.latitude
, zakres szerokości geograficznej jest pusty.
Musi być wypełnione zarówno niska, jak i wysoka, a reprezentowane pole nie może być puste. Gdy to zrobisz, pojawi się błąd.
Na przykład ten widoczny obszar w całości obejmuje Nowy Jork:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- Jeśli
locationRestriction
Określa obszar wyszukiwania. Wyniki spoza określonego obszaru nie są . Wskaż region jako prostokątny widoczny obszar. Zobacz opis z
locationBias
.Możesz wybrać
locationRestriction
lublocationBias
, ale nie w obu przypadkach. ElementlocationRestriction
określa parametr regionu, w którym muszą się znajdować wyniki, orazlocationBias
jako określenie regionu, w którym wyniki muszą znajdować się w pobliżu, ale mogą się znajdować poza regionem. w pobliżu.-
maxResultCount (wycofany)
Określa liczbę wyników (od 1 do 20) wyświetlanych na stronie. Na przykład ustawienie wartości
maxResultCount
na 5 spowoduje zwrócenie do 5 wyników na pierwszej stronie. Jeśli istnieje więcej wyników, które można zwrócić odpowiedź będzie zawierać elementnextPageToken
, który musisz określić może przejść do kolejnego żądania dostępu do następnej strony. evOptions
Określa parametry identyfikacji dostępnego pojazdu elektrycznego (EV) dzięki złączom do ładowania i szybkości ładowania.
connectorTypes
Filtrowanie według typu dostępnego w danym miejscu złącza ładowania EV. O miejsce, które nie obsługuje żadnego z typów oprogramowania sprzęgającego, zostanie odfiltrowane na zewnątrz. Obsługiwane typy złączy do ładowania pojazdów elektrycznych obejmują też połączone źródła zasilania (AC i DC) ładowarki, ładowarki Tesla, ładowarki zgodne z GB/T (do szybkiego ładowania EV Chinach) i ładowarek ściennych. Więcej informacji znajdziesz w dokumentacji dokumentację.
minimumChargingRateKw
Filtruje miejsca na podstawie minimalnej szybkości ładowania EV w kilowatach (kW). Dowolne miejsc, w których ładowanie jest niższe niż minimalna zostały odfiltrowane. Na przykład, aby znaleźć ładowarki EV o częstotliwości ładowania co najmniej 10 kW, możesz ustawić ten parametr na „10”.
minRating
Ogranicza wyniki tylko do tych, których średnia ocena użytkowników jest wyższa niż lub jej równy. Wartości muszą mieścić się w zakresie od 0,0 do 5.0 (włącznie) przyrosty co 0,5. Na przykład: 0, 0,5, 1,0, ... , 5,0 włącznie. Wartości to w górę do najbliższej 0,5. Na przykład wartość 0, 6 eliminuje wszystkie wyników z oceną niższą niż 1,0.
openNow
Jeśli
true
, zwróć tylko te miejsca, które są otwarte w momencie wysyłania zapytania. Jeślifalse
, zwróć wszystkie firmy bez względu na to, czy są otwarte. Miejsca, które nie określają godzin otwarcia w bazie danych Miejsc Google, zwracany, jeśli ustawisz ten parametr nafalse
.pageSize
Określa liczbę wyników (od 1 do 20) wyświetlanych na stronie. Na przykład ustawienie wartości
pageSize
na 5 spowoduje zwrócenie do 5 wyników na pierwszej stronie. Jeśli istnieje więcej wyników, które można zwrócić odpowiedź będzie zawierać elementnextPageToken
, który musisz określić może przejść do kolejnego żądania dostępu do następnej strony.pageToken
Określa pole
nextPageToken
z treści odpowiedzi poprzednia strona.-
priceLevels
Ogranicz wyszukiwanie do miejsc oznaczonych na określonych poziomach cen. Domyślnie wybrane są wszystkie poziomy cen.
Określ tablicę z co najmniej jedną wartością zdefiniowaną przez
PriceLevel
Na przykład:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Określa kolejność wyników w odpowiedzi na podstawie typu wartości zapytanie:
- W przypadku zapytania kategorialnego, np. „Restauracje w Warszawie”,
Ustawienie domyślne to
RELEVANCE
(ranking wyników według trafności wyszukiwania). Możesz ustawićrankPreference
naRELEVANCE
lubDISTANCE
(ranking wyników według odległości). - W przypadku zapytań niezwiązanych z kategorią, np. „Warszawa”, zalecamy
pozostawienie zasady
rankPreference
nieskonfigurowanej.
- W przypadku zapytania kategorialnego, np. „Restauracje w Warszawie”,
Ustawienie domyślne to
regionCode
Kod regionu używany do formatowania odpowiedzi podany jako dwuznakową wartość kodu CLDR. Ten parametr może również powodować odchylenie w wynikach wyszukiwania. Nie ma wartości domyślnej.
Jeśli nazwa kraju w polu
formattedAddress
w parametrze odpowiedź pasuje doregionCode
, kod kraju jest pomijany odformattedAddress
. Ten parametr nie ma wpływu naadrFormatAddress
, który zawsze obejmuje kraj. nazwa (jeśli jest dostępna) lub w systemieshortFormattedAddress
, który nigdy i je uwzględnia.Większość kodów CLDR jest identyczna z kodami ISO 3166-1. z kilkoma istotnymi wyjątkami. Na przykład domena ccTLD Wielkiej Brytanii to „uk” (co.uk), natomiast kod ISO 3166-1 to „gb”. (technicznie dla funkcji podmiotu „Wielkiej Brytanii i Irlandii Północnej”). Ten parametr może wpływać na wyniki w zależności od obowiązującego prawa.
strictTypeFiltering
Używana z parametrem
includedType
. Po ustawieniu natrue
, tylko miejsca pasujące do typów określonych przez Zwracane są wartościincludeType
. Jeśli wartością domyślną jest false (fałsz), odpowiedź domyślna może zawierać miejsca, które nie są zgodne określonych typów.
Przykłady wyszukiwania tekstowego
Znajdź miejsce na podstawie ciągu zapytania
Poniższy przykład pokazuje żądanie wyszukiwania tekstowego dla zapytania "pikantne dania wegetariańskie w Sydney”:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Zwróć uwagę, że nagłówek X-Goog-FieldMask
określa, że parametr
odpowiedź
zawiera następujące pola danych: places.displayName,places.formattedAddress
.
Odpowiedź ma postać:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
Aby zwracać dodatkowe informacje, dodaj do maski pola więcej typów danych.
Na przykład dodaj places.types,places.websiteUri
, aby uwzględnić
typu restauracji i adresu internetowego
odpowiedź:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
Odpowiedź ma teraz taki format:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
Filtruj miejsca według poziomu cen
Użyj opcji priceLevel
, aby filtrować wyniki według restauracji
zdefiniowane jako niedrogie lub umiarkowane:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
W tym przykładzie używamy również nagłówka X-Goog-FieldMask
, aby dodać
places.priceLevel
danych do funkcji
odpowiedź
więc ma postać:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
Dodaj więcej opcji zawężających wyszukiwanie, takie jak includedType
,
minRating
, rankPreference
, openNow
,
oraz innych parametrów opisanych w
Parametry opcjonalne.
Wyszukiwanie miejsc w okolicy
Użyj formy płatności locationRestriction
lub locationBias
.
ale nie jednocześnie, by ograniczyć wyszukiwanie do wybranego obszaru. Pomyśl o tym miejscu: locationRestriction
jako określenie regionu, w którym muszą się znajdować wyniki, oraz locationBias
określając region, w którym wyniki muszą znajdować się w pobliżu, ale mogą znajdować się poza regionem.
w pobliżu.
Poniższy przykład pokazuje żądanie wyszukiwania tekstowego dla zapytania „pikantne dania wegetariańskie” znajduje się w promieniu 500 metrów od punktu w w centrum San Francisco. To żądanie zwraca tylko 10 pierwszych wyników dla zapytania w otwartych miejscach.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Szukaj ładowarki EV z minimalną szybkością ładowania
Użyj minimumChargingRateKw
i connectorTypes
, aby
wyszukać miejsca, w których dostępne są ładowarki zgodne z Twoim pojazdem elektrycznym.
Przykład poniżej pokazuje żądanie ładowania pojazdów elektrycznych Tesla i J1772 typu 1 o mocy minimalnej 10 kW w Mountain View w Kalifornii. Tylko cztery wyniki.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
Żądanie zwraca taką odpowiedź:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
Określ liczbę wyników zwracanych na stronę
Użyj parametru pageSize
, aby określić liczbę wyników do
na stronę. Parametr nextPageToken
w treści odpowiedzi
udostępnia token, który można wykorzystać w kolejnych wywołaniach dostępu do następnej strony
wyników.
Przykład poniżej zawiera zapytanie o „pizza w Gdańsku” ograniczona do 5 wyników na stronę:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
Aby przejść do następnej strony wyników, użyj funkcji pageToken
do przekazania
nextPageToken
w treści żądania:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
Wypróbuj
API Explorer umożliwia wysyłanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.
Kliknij ikonę interfejsu API
. w prawej części strony.
Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw
fields
do pola .Opcjonalnie edytuj Treść żądania.
Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, na którym którego chcesz użyć do przesłania żądania.
W panelu Eksplorator API kliknij ikonę rozwijania.
, aby rozwinąć okno Eksploratora interfejsów API.