Wyszukiwanie tekstu (nowość)

Wybierz platformę: Android iOS JavaScript Usługa internetowa

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:

Wypróbuj

Żą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. Obiekt Place 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 lub fields albo za pomocą nagłówka HTTP X-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

      * Pole places.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 API en Jeśli podasz nieprawidłowy kod języka, interfejs API zwraca błąd INVALID_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 lub locationBias, ale nie w obu przypadkach. Element locationRestriction określa parametr regionu, w którym muszą się znajdować wyniki, oraz locationBias 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 i high.longitude = 180 stopni, widoczny obszar obejmuje wszystkie długości geograficznej.
      • Jeśli low.longitude = 180 stopni i high.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
    }
  }
}

  • 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 lub locationBias, ale nie w obu przypadkach. Element locationRestriction określa parametr regionu, w którym muszą się znajdować wyniki, oraz locationBias 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ć element nextPageToken, 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śli false, 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 na false.

  • 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ć element nextPageToken, 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 na RELEVANCE lub DISTANCE (ranking wyników według odległości).
    • W przypadku zapytań niezwiązanych z kategorią, np. „Warszawa”, zalecamy pozostawienie zasady rankPreference nieskonfigurowanej.

  • 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 do regionCode, kod kraju jest pomijany od formattedAddress. Ten parametr nie ma wpływu na adrFormatAddress, który zawsze obejmuje kraj. nazwa (jeśli jest dostępna) lub w systemie shortFormattedAddress, 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 na true, tylko miejsca pasujące do typów określonych przez Zwracane są wartości includeType. 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.

  1. Kliknij ikonę interfejsu API Rozwiń interfejs API Explorer.. w prawej części strony.

  2. Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw fields do pola .

  3. Opcjonalnie edytuj Treść żądania.

  4. Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, na którym którego chcesz użyć do przesłania żądania.

  5. W panelu Eksplorator API kliknij ikonę rozwijania. Rozwiń interfejs API Explorer., aby rozwinąć okno Eksploratora interfejsów API.