Text Search (New)

Plattform auswählen: Android iOS JavaScript Webdienst

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:

Testen!

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. Das Place-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 oder fields oder mithilfe des HTTP-Headers X-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 Feld places.name enthält den Ressourcennamen des Orts. im Format places/PLACE_ID. Verwenden Sie places.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äßig en. Wenn Sie einen ungültigen Sprachcode angeben, gibt einen INVALID_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 oder locationBias angeben. aber nicht beides. Stellen Sie sich locationRestriction vor, Region, in der sich die Ergebnisse befinden müssen, und locationBias 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 und high.longitude = 180 Grad, der Darstellungsbereich umfasst alle Längenangaben.
      • Wenn low.longitude = 180 Grad und high.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
    }
  }
}

  • 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 oder locationBias angeben. aber nicht beides. Stellen Sie sich locationRestriction vor, Region, in der sich die Ergebnisse befinden müssen, und locationBias 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 ein nextPageToken, 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. Wenn false, 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 auf false 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 ein nextPageToken, 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önnen rankPreference auf RELEVANCE setzen oder DISTANCE (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.

  • 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 mit regionCode überein, wird der Ländercode weggelassen von formattedAddress. Dieser Parameter hat keine Auswirkungen auf adrFormatAddress, was immer das Land enthält Name, falls verfügbar, oder auf shortFormattedAddress, 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 auf true, nur Orte, die den angegebenen Typen entsprechen, die durch includeType 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.

  1. Klicken Sie auf das API-Symbol Maximieren Sie API Explorer.. rechts auf der Seite.

  2. Maximieren Sie optional Standardparameter anzeigen und legen Sie das fields fest. Parameter auf das Feld Maske.

  3. Optional können Sie den Anfragetext bearbeiten.

  4. 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.

  5. Klicken Sie im API Explorer auf das Symbol zum Maximieren Maximieren Sie API Explorer., um das API Explorer-Fenster zu maximieren.