Method: places.searchText

Place Search-Ergebnisse, die auf Textabfragen basieren.

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,
  "pageSize": integer,
  "pageToken": string,
  "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 wurde, können Ortsdetails einer beliebigen Sprache zurückgegeben werden. Falls solche Details vorhanden sind, wird Englisch bevorzugt.

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

string

Der Unicode-Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden Ortsdetails wie der regionsspezifische Ortsname (sofern verfügbar) angezeigt. Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.

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

Beachten Sie, dass dreistellige Regionscodes derzeit nicht unterstützt werden.
rankPreference

enum (RankPreference)

Ranking der Ergebnisse in der Antwort
includedType

string

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

boolean

Beschränkt die Suche auf Orte, die derzeit geöffnet sind. Der Standardwert ist "false".
minRating

number

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

integer

Eingestellt: Verwende stattdessen pageSize.

Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden kann. Wenn die Anzahl der verfügbaren Ergebnisse größer als maxResultCount ist, wird ein nextPageToken zurückgegeben, das an pageToken übergeben werden kann, um in nachfolgenden Anfragen zur nächsten Seite mit Ergebnissen zu gelangen. Wenn der Wert 0 oder kein Wert angegeben wird, wird der Standardwert 20 verwendet. Der Maximalwert ist 20. werden Werte über 20 in 20 umgewandelt. Bei negativen Werten wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn sowohl maxResultCount als auch pageSize angegeben sind, wird maxResultCount ignoriert.
pageSize

integer

Optional. Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden kann. Wenn die Anzahl der verfügbaren Ergebnisse größer als pageSize ist, wird ein nextPageToken zurückgegeben, das an pageToken übergeben werden kann, um in nachfolgenden Anfragen zur nächsten Seite mit Ergebnissen zu gelangen. Wenn der Wert 0 oder kein Wert angegeben wird, wird der Standardwert 20 verwendet. Der Maximalwert ist 20. werden Werte über 20 auf 20 gesetzt. Bei negativen Werten wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn sowohl maxResultCount als auch pageSize angegeben sind, wird maxResultCount ignoriert.
pageToken

string

Optional. Seitentoken, das von einem vorherigen TextSearch-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle an TextSearch bereitgestellten Parameter außer pageToken, pageSize und maxResultCount mit dem ersten Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
priceLevels[]

enum (PriceLevel)

Beschränkt die Suche auf Orte, die als bestimmte Preisstufen gekennzeichnet sind. Nutzer können eine beliebige Kombination von Preisstufen auswählen. Standardmäßig werden alle Preisstufen ausgewählt.
strictTypeFiltering

boolean

Wird verwendet, um die strikte Typfilterung für „includedType“ festzulegen. Bei Einstellung auf „true“ 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, d. h., Ergebnisse in der Nähe eines bestimmten Standorts können zurückgegeben werden. Kann nicht zusammen mit „locationRestriction“ festgelegt werden.
locationRestriction

object (LocationRestriction)

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

object (EVOptions)

Optional. Legen Sie die durchsuchbaren Elektrofahrzeug-Optionen einer Ortssuchanfrage fest.

Antworttext

Antwortprototyp für places.searchText.

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

JSON-Darstellung 
{
  "places": [
    {
      object (Place)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string
}
Felder
places[]

object (Place)

Eine Liste von Orten, die den Textsuchkriterien des Nutzers entsprechen.
contextualContents[]

object (ContextualContent)

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Eine Liste von kontextbezogenen Inhalten, bei der jeder Eintrag mit dem entsprechenden Ort im selben Index im Ortsfeld verknüpft ist. Die Inhalte, die für die textQuery in der Anfrage relevant sind, werden bevorzugt. Wenn für einen der Orte kein kontextbezogener Inhalt verfügbar ist, wird nicht-kontextbezogener Inhalt zurückgegeben. Er ist nur dann leer, wenn die Inhalte für diesen Ort nicht verfügbar sind. Diese Liste muss auf Anfrage genauso viele Einträge enthalten wie die Liste der Orte.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird oder leer ist, gibt es keine nachfolgenden Seiten.

RankPreference

Ranking der Ergebnisse in der Antwort

Enums
RANK_PREFERENCE_UNSPECIFIED Für eine kategoriale Suchanfrage wie „Restaurants in New York City“ ist RELEVANCE die Standardabfrage. Für nicht kategorische Suchanfragen wie „Mountain View, CA“ empfehlen wir, „rankPreference“ nicht zu konfigurieren.
DISTANCE Die Ergebnisse werden nach Entfernung sortiert.
RELEVANCE Die Ergebnisse werden nach Relevanz sortiert. Die Sortierreihenfolge wird durch den normalen Ranking-Stack bestimmt.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Verzerrung, d. h., Ergebnisse in der Nähe eines bestimmten Standorts können zurückgegeben werden.

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)

Ein rechteckiges Feld, das von der nordöstlichen und südwestlichen 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. In diesem Fall ist der Breitengradbereich leer. 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, d. h., Ergebnisse außerhalb des angegebenen Standorts werden nicht zurückgegeben.

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)

Ein rechteckiges Feld, das von der nordöstlichen und südwestlichen 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. In diesem Fall ist der Breitengradbereich leer. Ein rechteckiger Darstellungsbereich darf nicht breiter als 180 Grad sein.

EVOptions

Durchsuchbare Elektrofahrzeug-Optionen einer Ortssuchanfrage

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

number

Optional. Erforderliche Mindestladerate in Kilowatt. Ein Ort, dessen Gebühren unter dem angegebenen Preis liegen, wird herausgefiltert.
connectorTypes[]

enum (EVConnectorType)

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

ContextualContent

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Inhalt, der für die Ortsabfrage kontextbezogen ist.

JSON-Darstellung 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Felder
reviews[]

object (Review)

Liste der Rezensionen zu diesem Ort, die zur Ortsabfrage stehen.
photos[]

object (Photo)

Informationen (einschließlich Verweisen) zu Fotos dieses Orts, die im Zusammenhang mit der Ortsabfrage stehen.
justifications[]

object (Justification)

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für den Ort.

Begründung

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für den Ort. Eine Begründung beantwortet die Frage, warum ein Ort für Endnutzer interessant sein könnte.

JSON-Darstellung 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Felder

Union-Feld justification.

Für justification ist nur einer der folgenden Werte zulässig:
reviewJustification

object (ReviewJustification)

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

ReviewJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Begründungen für Nutzerrezensionen. Dadurch wird ein Abschnitt der Nutzerrezension hervorgehoben, der Endnutzer interessiert. Wenn die Suchanfrage beispielsweise „pizza pizza“ lautet, wird in der Begründung für die Rezension der relevante Text für die Suchanfrage hervorgehoben.

JSON-Darstellung 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Felder
highlightedText

object (HighlightedText)
review

object (Review)

Die Rezension, aus der der markierte Text generiert wird.

HighlightedText

Der durch die Begründung hervorgehobene Text. Dies ist ein Teil der Rezension selbst. Das genaue Wort, das markiert werden soll, wird durch HighlightedTextRange markiert. Der Text könnte aus mehreren Wörtern bestehen.

JSON-Darstellung 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Felder
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Die Liste der Bereiche des markierten Textes.

HighlightedTextRange

Der Bereich des markierten Textes.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer
}
Felder
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. BusinessAvailabilityAttributes begründet. Hier sehen Sie einige Attribute eines Unternehmens, die für Endnutzer interessant sein könnten.

JSON-Darstellung 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Felder
takeout

boolean

Ob Speisen zum Mitnehmen angeboten werden
delivery

boolean

Ob ein Ort einen Lieferservice anbietet.
dineIn

boolean

Ob im Restaurant Speisemöglichkeiten angeboten werden