Eine Textsuche (Neu) gibt auf Basis eines Strings Informationen über eine Reihe von Orten zurück, z. B. „pizza in new york“ oder „Schuhgeschäfte in der Nähe von Hamburg“ oder "Hauptstraße 123". Die Der Dienst antwortet mit einer Liste von Orten, die der Textzeichenfolge und einem beliebigen Standort entsprechen. der festgelegten Verzerrungen.
Dieser Dienst ist besonders nützlich, um mehrdeutige Adressabfragen in einem automatisierten System verwendet werden, sodass die Zeichenfolgenkomponenten Unternehmen sowie Adressen. Beispiele für mehrdeutige Adressabfragen sind schlecht formatierten Adressen oder Anfragen, die Nicht-Adresskomponenten enthalten, als Unternehmensnamen. Anfragen wie in den ersten beiden Beispielen in der folgenden Tabelle gibt möglicherweise keine Ergebnisse zurück, es sei denn, ein Standort, wie z. B. Region, Standort, oder Standortverzerrung festgelegt ist.
„Musterstraße 10, 10117 Berlin“ oder "Hauptstraße 123, Deutschland" | Mehrere "High Streets" im Vereinigten Königreich: "Main Street" in den USA. Die Abfrage gibt nur dann die gewünschten Ergebnisse zurück, wenn eine Standortbeschränkung festgelegt ist: festgelegt. |
„ChainRestaurant New York“ | Mehrere „ChainRestaurant“ Standorte in New York keine Adresse oder sogar den Straßennamen. |
„10 High Street, Escher UK“ oder "Hauptstraße 123, München" | Nur eine "Hauptstraße" in der britischen Stadt Escher nur eine "Hauptstraße" in Pleasanton, Kalifornien, USA. |
„UniqueRestaurantName New York“ | Nur eine Einrichtung mit diesem Namen in New York keine Adresse unterscheiden können. |
„pizza restaurants in berlin“ | Diese Abfrage enthält eine Standortbeschränkung und "Pizzerien". ist einen klar definierten Ortstyp haben. Es werden mehrere Ergebnisse zurückgegeben. |
„+49 514 670 8700“ | Diese Abfrage enthält eine Telefonnummer. Es werden mehrere Ergebnisse für Orte, die mit dieser Telefonnummer verknüpft sind. |
Mit dem API Explorer können Sie Live-Anfragen stellen, damit Sie sich mit der API und den API-Optionen:
Text Search-Anfragen
Eine Text Search-Anfrage ist eine HTTP POST-Anfrage der folgenden Form:
https://places.googleapis.com/v1/places:searchText
Übergeben Sie alle Parameter im JSON-Anfragetext oder in Headern als Teil des POST-Anfrage. Beispiel:
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'
„Text Search (New)“-Antworten
gibt „Text Search (New)“ eine JSON-Objekt als Antwort an. In der Antwort:
- Das Array
places
enthält alle übereinstimmenden Orte. - Jeder Ort im Array wird durch einen
Place
-Objekt enthält. DasPlace
-Objekt enthält detaillierte Informationen zu einem einzelnen - Die in der Anfrage übergebene FieldMask gibt die
Liste der im Objekt
Place
zurückgegebenen Felder
Das vollständige JSON-Objekt hat das folgende Format:
{ "places": [ { object (Place) } ] }
Erforderliche Parameter
-
FieldMask
Geben Sie die Liste der Felder an, die in der Antwort zurückgegeben werden sollen, indem Sie ein Antwortfeldmaske. Übergeben Sie die Antwortfeldmaske mithilfe des URL-Parameters an die Methode.
$fields
oderfields
oder mithilfe des HTTP-HeadersX-Goog-FieldMask
Die Antwort enthält keine Standardliste mit zurückgegebenen Feldern. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.Die Maskierung von Feldern ist sinnvoll, um unnötige Daten zu verarbeiten, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.
Geben Sie eine durch Kommas getrennte Liste der Ortsdatentypen an, die zurückgegeben werden sollen. Beispiel: um den Anzeigenamen und die Adresse des Orts abzurufen.
X-Goog-FieldMask: places.displayName,places.formattedAddress
Verwenden Sie
*
, um alle Felder abzurufen.X-Goog-FieldMask: *
Geben Sie eines oder mehrere der folgenden Felder an:
Die folgenden Felder lösen die SKU „Text Search (ID Only)“ aus:
places.attributions
,places.id
,places.name
*nextPageToken
* Das Feldplaces.name
enthält den Ressourcennamen des Orts. im Formatplaces/PLACE_ID
. Verwenden Sieplaces.displayName
, um auf den Textnamen des Orts zuzugreifen.Die folgenden Felder lösen die SKU „Text Search (Basic)“ aus:
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
Die folgenden Felder lösen die SKU „Text Search (Advanced)“ aus:
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
Die folgenden Felder lösen die SKU „Text Search (Preferred)“ aus:
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
Die Textzeichenfolge, nach der gesucht werden soll, z. B. "restaurant", „Hauptstraße 123“ oder „beste Sehenswürdigkeit in San Francisco“. Die API gibt Kandidatenvorschläge zurück, die auf für diesen String und ordnet die Ergebnisse nach erkannter Relevanz.
Optionale Parameter
includedType
Beschränkt die Ergebnisse auf Orte, die dem angegebenen Typ entsprechen, der durch Tabelle A. Es kann nur ein Typ angegeben werden. Beispiel:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Weitere Informationen finden Sie in der Liste der unterstützten Sprachen. Google aktualisiert die unterstützten Sprachen häufig, daher ist diese Liste möglicherweise nicht vollständig sind.
-
Wenn
languageCode
nicht angegeben ist, verwendet die API standardmäßigen
. Wenn Sie einen ungültigen Sprachcode angeben, gibt einenINVALID_ARGUMENT
-Fehler zurück. - Die API versucht möglichst, eine Adresse bereitzustellen, die für sowohl für Nutzer als auch für Ortsansässige. Um dieses Ziel zu erreichen, gibt er Adressen in der Landessprache, in ein Skript umgewandelt, das von wenn nötig, unter Berücksichtigung der bevorzugten Sprache. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten sind alle in derselben Sprache zurückgegeben, die aus der ersten Komponente.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API den am genauesten übereinstimmen.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Suchergebnisse, und in welcher Reihenfolge sie zurückgegeben werden. Die Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, etwa die Abkürzungen für Straßentypen oder Synonyme, die möglicherweise in einer Sprache gültig sind, aber nicht in einer anderen.
locationBias
Gibt das Gebiet an, in dem gesucht werden soll. Dieser Standort dient als Verzerrung, können Ergebnisse im Umkreis des angegebenen Standorts zurückgegeben werden, einschließlich der Ergebnisse außerhalb des angegebenen Bereichs liegt.
Sie können
locationRestriction
oderlocationBias
angeben. aber nicht beides. Stellen Sie sichlocationRestriction
vor, Region, in der sich die Ergebnisse befinden müssen, undlocationBias
als Sie geben die Region an, in der sich die Ergebnisse befinden müssen, aber auch außerhalb liegen können in der Umgebung.Legen Sie den Bereich als rechteckigen Darstellungsbereich oder als Kreis fest.
Ein Kreis wird durch einen Mittelpunkt und einen Radius in Metern definiert. Der Radius muss zwischen 0,0 und 50000,0 (einschließlich) liegen. Der Standardradius ist 0,0. Beispiel:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Ein Rechteck ist der Darstellungsbereich mit Breiten- und Längengraden, diagonal gegenüberliegende niedrige und hohe Punkte. Der Tiefstpunkt markiert den Südwesten Ecke des Rechtecks. Der höchste Punkt stellt den Nordosten dar. des Rechtecks.
Ein Darstellungsbereich wird als geschlossene Region, d. h., sie umfasst ihre Begrenzung. Die Breitengradgrenzen muss zwischen -90 und einschließlich 90 Grad liegen und die Längengrenzen muss zwischen -180 und 180 Grad liegen:
- Wenn
low
=high
, besteht der Darstellungsbereich aus folgenden Elementen: einen einzigen Punkt. - Wenn
low.longitude
>high.longitude
, der wird der Längengradbereich invertiert (der Darstellungsbereich überschreitet den 180-Grad-Winkel Längengrad). - Wenn
low.longitude
= -180 Grad undhigh.longitude
= 180 Grad, der Darstellungsbereich umfasst alle Längenangaben. - Wenn
low.longitude
= 180 Grad undhigh.longitude
= -180 Grad, der Längengradbereich ist leer. - Wenn
low.latitude
>high.latitude
, der Der Breitengradbereich ist leer.
Die Werte für „Niedrig“ und „Hoch“ müssen ausgefüllt werden. Das dargestellte Feld darf nicht leer. Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Darstellungsbereich schließt beispielsweise New York City vollständig ein:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- Wenn
locationRestriction
Gibt das Gebiet an, in dem gesucht werden soll. Ergebnisse außerhalb des angegebenen Bereichs werden nicht zurückgegeben. Legen Sie den Bereich als rechteckigen Darstellungsbereich fest. Beschreibung ansehen von
locationBias
finden Sie weitere Informationen zum Definieren des Darstellungsbereichs.Sie können
locationRestriction
oderlocationBias
angeben. aber nicht beides. Stellen Sie sichlocationRestriction
vor, Region, in der sich die Ergebnisse befinden müssen, undlocationBias
als Sie geben die Region an, in der sich die Ergebnisse befinden müssen, aber auch außerhalb liegen können in der Umgebung.-
maxResultCount (eingestellt)
Gibt die Anzahl der Ergebnisse (zwischen 1 und 20) an, die pro Seite angezeigt werden sollen. Wenn Sie beispielsweise für
maxResultCount
den Wert 5 festlegen, werden bis zu 5 zurückgegeben. auf der ersten Seite angezeigt. Wenn es mehr Ergebnisse gibt, die zurückgegeben werden können enthält die Antwort einnextPageToken
, das Sie die an eine nachfolgende Anfrage übergeben werden können, um auf die nächste Seite zuzugreifen. evOptions
Gibt Parameter zur Identifizierung verfügbarer Elektrofahrzeuge an Ladeanschlüssen und Ladegeschwindigkeiten.
connectorTypes
Filtert nach dem Typ des an einem Ort verfügbaren Ladeanschlusses für Elektrofahrzeuge. A Ort, der keinen der Connector-Typen unterstützt, wird gefiltert. aus. Unterstützte Anschlusstypen für das Laden von Elektrofahrzeugen sind kombinierte Anschlusstypen (AC und DC) Ladegeräte, Tesla-Ladegeräte, GB/T-konforme Ladegeräte (für die Schnellladefunktion für Elektrofahrzeuge in China) und Ladegeräte für Steckdosen. Weitere Informationen finden Sie in der Referenz Dokumentation.
minimumChargingRateKw
Filtert Orte nach der Mindestladerate für Elektrofahrzeuge in Kilowatt (kW). Beliebig Orte, an denen die Ladegeschwindigkeit unter der Mindestladerate liegt, herausgefiltert. Um beispielsweise Ladestationen für Elektrofahrzeuge zu finden, mindestens 10 kW haben, können Sie diesen Parameter auf „10“ setzen.
minRating
Beschränkt die Ergebnisse auf Nutzer, deren durchschnittliche Nutzerbewertung höher ist als oder diesem Limit entsprechen. Die Werte müssen zwischen 0,0 und 5,0 (einschließlich) in in Schritten von 0,5. Beispiel: 0, 0,5, 1,0, ... , 5,0 (jeweils einschließlich). Mögliche Werte: auf 0,5 aufgerundet. Beispiel: Bei einem Wert von 0, 6 werden alle mit einer Bewertung unter 1,0.
openNow
Wenn
true
, werden nur die Orte zurückgegeben, die geöffnet sind. wenn die Abfrage gesendet wird. Wennfalse
, alle Unternehmen zurückgeben unabhängig vom Öffnungsstatus. Orte, für die in der Google Places-Datenbank keine Öffnungszeiten angegeben sind, sind wird zurückgegeben, wenn Sie diesen Parameter auffalse
festlegen.pageSize
Gibt die Anzahl der Ergebnisse (zwischen 1 und 20) an, die pro Seite angezeigt werden sollen. Wenn Sie beispielsweise für
pageSize
den Wert 5 festlegen, werden bis zu 5 zurückgegeben. auf der ersten Seite angezeigt. Wenn es mehr Ergebnisse gibt, die zurückgegeben werden können enthält die Antwort einnextPageToken
, das Sie die an eine nachfolgende Anfrage übergeben werden können, um auf die nächste Seite zuzugreifen.pageToken
Gibt die
nextPageToken
aus dem Antworttext der vorherige Seite.-
priceLevels
Sie können die Suche auf Orte beschränken, die mit bestimmten Preisstufen gekennzeichnet sind. Standardmäßig werden alle Preisstufen ausgewählt.
Geben Sie ein Array mit einem oder mehreren Werten an, die durch
PriceLevel
Beispiel:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Gibt an, wie die Ergebnisse in der Antwort basierend auf dem Typ Suchanfrage:
- Für eine kategoriale Suchanfrage wie „Restaurants in New York City“:
RELEVANCE
(Ergebnisse nach Suchrelevanz sortieren) ist die Standardeinstellung. Sie könnenrankPreference
aufRELEVANCE
setzen oderDISTANCE
(Ergebnisse nach Entfernung sortieren). - Für eine nicht kategoriale Suchanfrage wie „Mountain View, CA“ empfehlen wir
für die Sie keinen Wert für „
rankPreference
“ festlegen.
- Für eine kategoriale Suchanfrage wie „Restaurants in New York City“:
regionCode
Der Regionscode, der zum Formatieren der Antwort verwendet wird, angegeben als zweistelligen CLDR-Code eingeben. Dieser Parameter kann auch eine Verzerrung in den Suchergebnissen. Es gibt keinen Standardwert.
Wenn der Ländername des Felds
formattedAddress
in der Antwort stimmt mitregionCode
überein, wird der Ländercode weggelassen vonformattedAddress
. Dieser Parameter hat keine Auswirkungen aufadrFormatAddress
, was immer das Land enthält Name, falls verfügbar, oder aufshortFormattedAddress
, der nie enthält.Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen nennenswerten Ausnahmen. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit des Vereinigten Königreichs Großbritannien und Nordirland“). Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.
strictTypeFiltering
Wird mit dem Parameter
includedType
verwendet. Wenn festgelegt auftrue
, nur Orte, die den angegebenen Typen entsprechen, die durchincludeType
zurückgegeben. Ist die Richtlinie auf „false“ gesetzt, kann die Antwort Orte enthalten, die nicht übereinstimmen. den angegebenen Typen.
Text Search-Beispiele
Ort über einen Abfragestring suchen
Das folgende Beispiel zeigt eine Text Search-Anfrage für „Spicy Vegetarian Food in Sydney, Australia“:
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'
Der X-Goog-FieldMask
-Header gibt an, dass die
Antwort
enthält die folgenden Datenfelder: places.displayName,places.formattedAddress
.
Die Antwort hat dann folgendes Format:
{ "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" } }, ... ] }
Fügen Sie der Feldmaske weitere Datentypen hinzu, um zusätzliche Informationen zurückzugeben.
Fügen Sie beispielsweise places.types,places.websiteUri
hinzu, um den Parameter
den Restauranttyp und die Webadresse im
Antwort:
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'
Die Antwort hat nun das folgende 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" } }, ... ] }
Orte nach Preisstufe filtern
Mit der Option priceLevel
kannst du die Ergebnisse nach Restaurants filtern
als günstig oder mäßig teuer definiert:
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'
In diesem Beispiel wird mit dem X-Goog-FieldMask
-Header auch der Parameter
places.priceLevel
-Datenfeld in den
Antwort
daher hat er folgendes Format:
{ "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" } }, ... ] }
Fügen Sie weitere Optionen hinzu, um Ihre Suche zu verfeinern, z. B. includedType
,
minRating
, rankPreference
, openNow
und anderen Parametern, die in
Optionale Parameter:
Nach Orten in einem Gebiet suchen
Verwenden Sie locationRestriction
oder locationBias
,
aber nicht beides, um die Suche auf ein bestimmtes Gebiet zu beschränken. Denken Sie an locationRestriction
durch Angabe der Region, in der sich die Ergebnisse befinden müssen, und locationBias
da die Region angegeben wird, in der sich die Ergebnisse in der Nähe befinden müssen, aber außerhalb dieser liegen können.
in der Umgebung.
Das folgende Beispiel zeigt eine Text Search-Anfrage für „Scharfes vegetarisches Essen“ weniger als 500 Meter von einem Punkt in der Innenstadt von San Francisco. Diese Anfrage gibt nur die ersten zehn Ergebnisse für die geöffnet sind.
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'
Nach Ladestationen für Elektrofahrzeuge mit Mindestladestand suchen
minimumChargingRateKw
und connectorTypes
für Folgendes verwenden:
nach Orten mit verfügbaren Ladegeräten suchen, die mit Ihrem Elektrofahrzeug kompatibel sind.
Das folgende Beispiel zeigt eine Anfrage für das Laden eines Elektrofahrzeugs mit Tesla und J1772 Typ 1. Anschlüsse mit einer Mindestladeleistung von 10 kW in Mountain View, Kalifornien. Nur vier Ergebnisse zurückgegeben.
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'
Die Anfrage gibt die folgende Antwort zurück:
{ "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 } ] } } ] }
Geben Sie die Anzahl der Ergebnisse an, die pro Seite zurückgegeben werden sollen
Verwenden Sie den Parameter pageSize
, um eine Anzahl von Ergebnissen anzugeben,
pro Seite zurückgegeben werden. Der nextPageToken
-Parameter im Antworttext
stellt ein Token bereit, das in nachfolgenden Aufrufen für den Zugriff auf die nächste Seite von
Ergebnisse.
Das folgende Beispiel zeigt eine Anfrage für „Pizza in New York“. begrenzt auf 5 Ergebnisse pro Seite:
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" }
Um auf die nächste Ergebnisseite zuzugreifen, übergeben Sie mit pageToken
die
nextPageToken
im Anfragetext:
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" }
Testen!
Mit dem API Explorer können Sie Beispielanfragen stellen, damit Sie sich mit der API und den API-Optionen vertraut machen können.
Klicken Sie auf das API-Symbol
. rechts auf der Seite.
Maximieren Sie optional Standardparameter anzeigen und legen Sie das
fields
fest. Parameter auf das Feld Maske.Optional können Sie den Anfragetext bearbeiten.
Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Dialogfeld das Konto aus, die Sie für die Anfrage verwenden möchten.
Klicken Sie im API Explorer auf das Symbol zum Maximieren
, um das API Explorer-Fenster zu maximieren.