Mit der Funktion Text Search (New) werden anhand eines Strings, z. B. „Pizza in New York“, „Schuhgeschäfte in der Nähe von Hamburg“ oder „Hauptstraße 123“, Informationen zu verschiedenen Orten zurückgegeben. Der Dienst gibt eine Liste von Orten zurück, die dem Textstring und der festgelegten Standortgewichtung entsprechen.
Der Dienst ist besonders nützlich, um mehrdeutige Adressabfragen in einem automatisierten System durchzuführen. Nicht adressierte Komponenten des Strings können sowohl mit Unternehmen als auch mit Adressen übereinstimmen. Beispiele für mehrdeutige Adressabfragen sind schlecht formatierte Adressen oder Anfragen, die Nicht-Adresskomponenten wie Unternehmensnamen enthalten. Anfragen wie in den ersten beiden Beispielen in der folgenden Tabelle können null Ergebnisse zurückgeben, sofern kein Standort festgelegt ist, z. B. Region, Standortbeschränkung oder Standortgewichtung.
„Hauptstraße 10, Deutschland“ oder „Hauptstraße 12, USA“ | Mehrere „High Streets“ im Vereinigten Königreich und mehrere „Main Streets“ in den USA. Die Abfrage gibt nur dann die gewünschten Ergebnisse zurück, wenn eine Standortbeschränkung festgelegt ist. |
„ChainRestaurant New York“ | Mehrere „ChainRestaurant“-Standorte in New York; keine Adresse und kein Straßenname. |
„10 High Street, Escher UK“ oder „123 Main Street, Pleasanton US“ | In der britischen Stadt Escher gibt es nur eine "High Street" und in der US-amerikanischen Stadt Pleasanton, nur eine "Main Street". |
„UniqueRestaurantName New York“ | Nur ein Unternehmen mit diesem Namen in New York; keine Adresse zur Unterscheidung erforderlich. |
„pizza restaurants in new york“ | Diese Abfrage enthält die Standortbeschränkung. „Pizzarestaurants“ ist ein klar definierter Ortstyp. Es werden mehrere Ergebnisse zurückgegeben. |
„+49 514 670 8700“ | Diese Abfrage enthält eine Telefonnummer. Es werden mehrere Ergebnisse für Orte zurückgegeben, die mit dieser Telefonnummer verknüpft sind. |
Mit dem API Explorer können Sie Live-Anfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:
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 der 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“-Antworten (New)
„Text Search (New)“ gibt ein JSON-Objekt als Antwort zurück. In der Antwort:
- Das Array
places
enthält alle übereinstimmenden Orte. - Jeder Ort im Array wird durch ein
Place
-Objekt dargestellt. DasPlace
-Objekt enthält detaillierte Informationen zu einem einzelnen Ort. - Die in der Anfrage übergebene FieldMask gibt die Liste der Felder an, die im Objekt
Place
zurückgegeben werden.
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 eine Antwortfeldmaske erstellen. Übergeben Sie die Antwortfeldmaske mit dem URL-Parameter
$fields
oderfields
oder mit dem HTTP-HeaderX-Goog-FieldMask
an die Methode. Die Antwort enthält keine Standardliste der zurückgegebenen Felder. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.Die Maskierung von Feldern hat sich bewährt, damit keine unnötigen Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Geben Sie eine durch Kommas getrennte Liste von Ortsdatentypen an, die zurückgegeben werden sollen. Beispiel: Der Anzeigename und die Adresse des Orts werden abgerufen.
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:
Durch die folgenden Felder wird die SKU „Text Search (ID Only)“ ausgelöst:
places.id
,places.name
*
* Das Feldplaces.name
enthält den Ressourcennamen in folgendem Format:places/PLACE_ID
. Verwenden Sieplaces.displayName
, um auf den Textnamen des Orts zuzugreifen.Durch die folgenden Felder wird die SKU „Text Search (Basic)“ ausgelöst:
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
, {1/7/}, {2/7, {2/7/}, {2/7, {2/7/}, {2/7, {2/7/}, {2/7/}, {2/7,{2/7,{2/2/2,2/2},places.menuForChildren
,places.menuForChildren
,places.parkingOptions
,places.menuForChildren
,places.parkingOptions
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
-
textQuery
Der Textstring, nach dem gesucht werden soll, z. B. „Restaurant“, „Hauptstraße 123“ oder „bester Ort in San Francisco“. Die API gibt mögliche Übereinstimmungen basierend auf diesem String zurück und ordnet die Ergebnisse nach erkannter Relevanz.
Optionale Parameter
includedType
Beschränkt die Ergebnisse auf Orte, die dem in Tabelle A definierten Typ entsprechen. Es kann nur ein Typ angegeben werden. Beispiel:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden von Google häufig aktualisiert. Daher ist diese Liste unter Umständen nicht vollständig.
-
Wenn
languageCode
nicht angegeben ist, wird die API standardmäßig aufen
gesetzt. Wenn Sie einen ungültigen Sprachcode angeben, gibt die API den FehlerINVALID_ARGUMENT
zurück. - Die API versucht, eine Adresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Adressen in der lokalen Sprache zurückgegeben und bei Bedarf in ein für den Nutzer lesbares Skript transkribiert. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die in der ersten Komponente ausgewählt wird.
- Wenn ein Name nicht in der bevorzugten Sprache verfügbar ist, verwendet die API die beste Übereinstimmung.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, sowie die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht.
locationBias
Gibt einen zu durchsuchenden Bereich an. Dieser Standort dient als Verzerrung, das heißt, dass Ergebnisse rund um den angegebenen Standort zurückgegeben werden können, auch Ergebnisse außerhalb des angegebenen Bereichs.
Sie können
locationRestriction
oderlocationBias
angeben, aber nicht beides. Stellen Sie sichlocationRestriction
als die Angabe der Region vor, in der sich die Ergebnisse befinden müssen, undlocationBias
als die Angabe der Region, in der sich die Ergebnisse in der Nähe, aber außerhalb dieses Bereichs befinden müssen.Legen Sie den Bereich als rechteckigen Darstellungsbereich oder als Kreis fest.
Ein Kreis wird durch den Mittelpunkt und einen Radius in Metern definiert. Der Radius muss zwischen 0,0 und 50000,0 (jeweils einschließlich) liegen. Der Standardradius ist 0,0. Beispiel:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Ein Rechteck ist ein Darstellungsbereich aus Breiten- und Längengrad, der als zwei diagonal gegenüberliegende niedrige und hohe Punkte dargestellt wird. Der Tiefpunkt markiert die südwestliche Ecke des Rechtecks und der höchste Punkt die nordöstliche Ecke des Rechtecks.
Ein Darstellungsbereich wird als geschlossener Bereich betrachtet, d. h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad (jeweils einschließlich):
- Wenn
low
=high
ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt. - Wenn
low.longitude
>high.longitude
ist, wird der Längengradbereich invertiert (der Darstellungsbereich kreuzt die 180-Grad-Längengradlinie). - Ist
low.longitude
= -180 Grad undhigh.longitude
= 180 Grad, enthält der Darstellungsbereich alle Längengrade. - Wenn
low.longitude
= 180 Grad undhigh.longitude
= -180 Grad ist, ist der Längengradbereich leer. - Wenn
low.latitude
>high.latitude
ist, ist der Breitengradbereich leer.
Sowohl „niedrig“ als auch „hoch“ muss ausgefüllt werden und das dargestellte Feld darf nicht leer sein. Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Darstellungsbereich umfasst beispielsweise New York City:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- Wenn
locationRestriction
Gibt einen zu durchsuchenden Bereich an. Ergebnisse außerhalb des angegebenen Bereichs werden nicht zurückgegeben. Geben Sie die Region als rechteckigen Darstellungsbereich an. Informationen zum Definieren des Darstellungsbereichs finden Sie in der Beschreibung von
locationBias
.Sie können
locationRestriction
oderlocationBias
angeben, aber nicht beides. Stellen Sie sichlocationRestriction
als die Angabe der Region vor, in der sich die Ergebnisse befinden müssen, undlocationBias
als die Angabe der Region, in der sich die Ergebnisse in der Nähe, aber außerhalb dieses Bereichs befinden müssen.-
maxResultCount
Gibt die maximale Anzahl der Ortsergebnisse an, die zurückgegeben werden sollen. Der Wert muss zwischen 1 und 20 (Standardwert) liegen.
evOptions
Gibt Parameter für die Ermittlung verfügbarer Ladeanschlüsse für Elektrofahrzeuge und Laderaten an.
connectorTypes
Nach dem an einem Ort verfügbaren Typ des Ladeanschlusses für Elektrofahrzeuge filtern. Orte, die keinen der Connector-Typen unterstützen, werden herausgefiltert. Zu den unterstützten Anschlusstypen für Elektrofahrzeuge gehören Kombi-Ladegeräte (AC und Gleichstrom), Tesla-Ladegeräte, GB/T-kompatible Ladegeräte (für die Schnellladefunktion für Elektrofahrzeuge in China) und Ladegeräte für Steckdosen. Weitere Informationen finden Sie in der Referenzdokumentation.
minimumChargingRateKw
Orte werden nach der Mindestladerate für Elektrofahrzeuge in Kilowatt (kW) gefiltert. Orte, an denen die Kosten unter der Mindestladerate liegen, werden herausgefiltert. Wenn Sie beispielsweise Ladestationen für Elektrofahrzeuge finden möchten, deren Ladeleistung mindestens 10 kW beträgt, können Sie diesen Parameter auf „10“ setzen.
minRating
Beschränkt die Ergebnisse auf die Nutzer, deren durchschnittliche Nutzerbewertung größer oder gleich dieser Grenze ist. Werte müssen zwischen 0,0 und 5,0 (einschließlich) in Schritten von 0,5 liegen. Beispiel: 0, 0,5, 1,0, ... , einschließlich 5,0. Die Werte werden auf den nächsten 0,5 aufgerundet. Beispielsweise werden bei einem Wert von 0,6 alle Ergebnisse mit einer Bewertung unter 1,0 ausgeschlossen.
openNow
Bei
true
werden nur die Orte zurückgegeben, die beim Senden der Abfrage geöffnet sind. Beifalse
werden alle Unternehmen zurückgegeben, unabhängig vom Status „Geöffnet“. Wenn du den Parameter auffalse
setzt, werden Orte zurückgegeben, für die in der Google Places-Datenbank keine Öffnungszeiten angegeben sind.-
priceLevels
Schränken Sie die Suche auf Orte ein, die mit bestimmten Preisstufen gekennzeichnet sind. Standardmäßig werden alle Preisstufen ausgewählt.
Geben Sie ein Array mit einem oder mehreren durch
PriceLevel
definierten Werten an.Beispiel:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Gibt an, wie die Ergebnisse in der Antwort auf Basis des Abfragetyps eingestuft werden:
- Für eine kategoriale Abfrage wie „Restaurants in New York City“ ist
RELEVANCE
(Ergebnisse nach Suchrelevanz sortieren) die Standardeinstellung. Sie könnenrankPreference
aufRELEVANCE
oderDISTANCE
setzen (Ergebnisse nach Entfernung sortieren). - Für eine nicht kategoriale Abfrage wie „Mountain View, CA“ empfehlen wir,
rankPreference
nicht festzulegen.
- Für eine kategoriale Abfrage wie „Restaurants in New York City“ ist
regionCode
Der zum Formatieren der Antwort verwendete Regionscode, angegeben als zweistelliger CLDR-Code-Wert. Dieser Parameter kann sich auch negativ auf die Suchergebnisse auswirken. Es gibt keinen Standardwert.
Wenn der Ländername des Felds
formattedAddress
in der Antwort mit demregionCode
übereinstimmt, wird der Ländercode beiformattedAddress
weggelassen. Dieser Parameter hat keine Auswirkungen aufadrFormatAddress
, das immer den Ländernamen enthält, sofern verfügbar, oder aufshortFormattedAddress
, der ihn nie enthält.Die meisten CLDR-Codes sind mit ISO 3166-1-Codes identisch. Es gibt jedoch einige 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 „The United Kingdom of Great Britain and Northern Ireland“). Der Parameter kann sich gemäß anwendbarem Recht auf Ergebnisse auswirken.
strictTypeFiltering
Wird mit dem Parameter
includeType
verwendet. Wenntrue
festgelegt ist, werden nur Orte zurückgegeben, die den inincludeType
angegebenen Typen entsprechen. Ist der Wert „false“, kann die Antwort standardmäßig Orte enthalten, die nicht den angegebenen Typen entsprechen.
Text Search – Beispiele
Ort anhand des Abfragestrings suchen
Das folgende Beispiel zeigt eine Text Search-Anfrage für „Spicy Vegetarian Food in Sydney, Australia“ (Spicy Vegetarian Food in Sydney, Australien):
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 Header X-Goog-FieldMask
gibt an, dass die Antwort die folgenden Datenfelder enthält: 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 Restauranttyp und die Webadresse in die Antwort aufzunehmen:
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 jetzt 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 Preisniveau filtern
Verwenden Sie die Option priceLevel
, um die Ergebnisse nach Restaurants zu filtern, die als günstig oder mäßig teuer eingestuft werden:
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 auch der Header X-Goog-FieldMask
verwendet, um der Antwort das Datenfeld places.priceLevel
hinzuzufügen, sodass es das folgende Format hat:
{ "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 zusätzliche Optionen hinzu, um die Suche einzugrenzen, z. B. includedType
, minRating
, rankPreference
, openNow
und andere unter Optionale Parameter beschriebene Parameter.
Orte in einem Gebiet suchen
Verwenden Sie locationRestriction
oder locationBias
, aber nicht beides, um die Suche auf einen Bereich einzuschränken. Stellen Sie sich locationRestriction
so vor, dass die Region, in der sich die Ergebnisse befinden müssen, und locationBias
als die Region definiert, in der sich die Ergebnisse befinden müssen, aber außerhalb dieses Bereichs liegen müssen.
Das folgende Beispiel zeigt eine „Text Search“-Anfrage für „Spicy Vegetarian Food“ (Spicy Vegetarian Food). Die Tendenz ist eingegrenzt, nicht mehr als 500 Meter von einem Punkt in der Innenstadt von San Francisco entfernt zu sein. Bei dieser Anfrage werden nur die ersten zehn Ergebnisse für geöffnete Orte zurückgegeben.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "maxResultCount": 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'
Ladestationen für Elektrofahrzeuge mit einer minimalen Ladegeschwindigkeit suchen
Verwenden Sie minimumChargingRateKw
und connectorTypes
, um nach Orten zu suchen, an denen Ladegeräte verfügbar sind, die mit Ihrem Elektrofahrzeug kompatibel sind.
Das folgende Beispiel zeigt eine Anfrage nach Ladekabeln von Tesla und J1772 für E-Fahrzeuge des Typs 1 mit einer Mindestladeleistung von 10 kW in Mountain View, Kalifornien. Es werden nur vier Ergebnisse zurückgegeben.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "maxResultCount": 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 } ] } } ] }
Jetzt testen
Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
Wählen Sie rechts auf der Seite das API-Symbol aus.
Maximieren Sie optional Standardparameter anzeigen und legen Sie für den Parameter
fields
die Feldmaske fest.Bearbeiten Sie optional den Anfragetext.
Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.
Wählen Sie im Bereich „API Explorer“ das Symbol „Maximieren“ aus, um das Fenster „API Explorer“ zu maximieren.