Method: places.searchText

Textabfragebasierte Ortssuche

HTTP-Anfrage

POST https://places.googleapis.com/v1/places:searchText

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Felder
textQuery

string

Erforderlich. Die Textabfrage für die Textsuche.
languageCode

string

Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Ortsdetails beliebiger Sprachen zurückgegeben werden, wobei Englisch bevorzugt wird.

Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Der Unicode-Ländercode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname (falls verfügbar). Der Parameter kann sich gemäß anwendbarem Recht auf Ergebnisse auswirken.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Dreistellige Regionscodes werden derzeit nicht unterstützt.
rankPreference

enum (RankPreference)

Wie die Ergebnisse in der Antwort sortiert werden.
includedType

string

Der angeforderte Ortstyp. Eine vollständige Liste der unterstützten Typen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. Es wird nur ein eingeschlossener Typ unterstützt.
openNow

boolean

Wird verwendet, um die Suche auf Orte einzuschränken, die derzeit geöffnet sind. Der Standardwert ist "false".
minRating

number

Filtern Sie Ergebnisse heraus, deren durchschnittliche Nutzerbewertung grundsätzlich unter diesem Grenzwert liegt. Ein gültiger Wert muss eine Gleitkommazahl zwischen 0 und 5 (einschließlich) mit einer Kadenz von 0,5 sein, d. h. [0, 0,5, 1,0, ... , 5,0] (jeweils einschließlich). Die Eingabe wird auf die nächste 0,5(Obergrenze) aufgerundet. Beispielsweise werden bei einer Bewertung von 0,6 alle Ergebnisse mit einer Bewertung unter 1,0 ausgeschlossen.
maxResultCount

integer

Maximale Anzahl der zurückzugebenden Ergebnisse; Der Wert muss zwischen 1 und 20 liegen. Der Standardwert ist 20. Wenn die Zahl nicht festgelegt ist, wird die Obergrenze zurückgesetzt. Wenn die Zahl negativ ist oder die Obergrenze überschreitet, wird der Fehler INVALID_ ARGUMENT zurückgegeben.
priceLevels[]

enum (PriceLevel)

Wird verwendet, um die Suche auf Orte zu beschränken, die mit bestimmten Preisstufen gekennzeichnet sind. Nutzer können beliebige Kombinationen von Preisstufen auswählen. Standardmäßig werden alle Preisstufen ausgewählt.
strictTypeFiltering

boolean

Wird verwendet, um eine strikte Filterung nach „includedType“ festzulegen. Wenn die Richtlinie auf „true“ gesetzt ist, werden nur Ergebnisse desselben Typs zurückgegeben. Die Standardeinstellung ist „false“.
locationBias

object (LocationBias)

Die Region, in der gesucht werden soll. Dieser Standort dient als Verzerrung, das heißt, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können. Kann nicht zusammen mit „locationRestriction“ festgelegt werden.
locationRestriction

object (LocationRestriction)

Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung, was bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden. Kann nicht zusammen mit locationBias festgelegt werden.
evOptions

object (EVOptions)

Optional. Die Optionen für durchsuchbare Elektrofahrzeuge einer Ortssuchanfrage festlegen

Antworttext

Antwortproto für „place.searchText“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "places": [
    {
      object (Place)
    }
  ]
}
Felder
places[]

object (Place)

Eine Liste von Orten, die den Kriterien der Textsuche des Nutzers entsprechen.

RankPreference

Wie die Ergebnisse in der Antwort sortiert werden.

Enums
RANK_PREFERENCE_UNSPECIFIED Für eine kategoriale Abfrage wie „Restaurants in New York City“ ist RELEVANCE der Standardwert. Für nicht kategoriale Abfragen wie „Mountain View, CA“ empfehlen wir, rankpreferences nicht zu konfigurieren.
DISTANCE Ergebnisse werden nach Entfernung sortiert.
RELEVANCE Die Ergebnisse werden nach Relevanz sortiert. Die Sortierreihenfolge wird durch einen normalen Ranking-Stack bestimmt.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Verzerrung, das heißt, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können.

JSON-Darstellung 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:
rectangle

object (Viewport)

Rechteckfeld, das durch die nordöstliche und die südwestliche Ecke definiert wird rectangle.high() muss der nordöstliche Punkt des rechteckigen Darstellungsbereichs sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Darstellungsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Darstellungsbereich darf nicht breiter als 180 Grad sein.
circle

object (Circle)

Ein durch Mittelpunkt und Radius definierter Kreis.

LocationRestriction

Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung, was bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden.

JSON-Darstellung 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:
rectangle

object (Viewport)

Rechteckfeld, das durch die nordöstliche und die südwestliche Ecke definiert wird rectangle.high() muss der nordöstliche Punkt des rechteckigen Darstellungsbereichs sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Darstellungsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Darstellungsbereich darf nicht breiter als 180 Grad sein.

EVOptions

Durchsuchbare Optionen für Elektrofahrzeuge einer Ortssuchanfrage.

JSON-Darstellung 
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Felder
minimumChargingRateKw

number

Optional. Erforderliche Mindestladeleistung in Kilowatt. Orte, deren Kosten unter dem angegebenen Tarif liegen, wird herausgefiltert.
connectorTypes[]

enum (EVConnectorType)

Optional. Die Liste der bevorzugten Steckertypen für Elektrofahrzeuge. Ein Ort, der keinen der aufgeführten Connector-Typen unterstützt, wird herausgefiltert.