Method: searchText

Mit einer Textanfrage nach Orten suchen.

HTTP-Anfrage

POST https://mapstools.googleapis.com/v1alpha: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,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Felder
textQuery

string

Erforderlich. Die Textabfrage.
languageCode

string

Optional. Die Sprache, in der die Zusammenfassung zurückgegeben werden soll. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, wird die Zusammenfassung mit einer Präferenz für Englisch zurückgegeben.

Beispiel: „en“ für Englisch.

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

string

Optional. Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt, im Unicode-Format. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, falls verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

Beispiel: „DE“ für Deutschland.

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

integer

Optional. Die maximale Anzahl der zurückzugebenden Orte (bis zu 10). Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Standardwert ist 5.

Wenn Sie mehr als 5 Orte anfordern, wird die Pro-Stufe ausgelöst, was zu höheren in Rechnung gestellten Kosten und einer höheren Latenz führt.
includeExtendedDetails

boolean

Optional. Enthält erweiterte Ortsdetails in der Antwort.

Setzen Sie dieses Feld auf true, wenn die Nutzeranfrage umfassende qualitative Informationen, Echtzeitdynamik oder spezielle Entitätsattribute erfordert: - Qualitative Rezensionen, Kundenstimmung und Feedback. - Spezifische Angebote wie Menüpunkte, Gerichte, Spezialitäten, Getränke oder Highlights des Unternehmens. – Qualitative Atmosphäre, Inneneinrichtung, Ästhetik, Ambiente oder Stimmung. - Echtzeitdaten und spezielle Informationen zu Einrichtungen, Besucherrichtlinien/-tipps, Wartezeiten.

Lassen Sie false (Standard) für Standardsuchen (z.B. Küchen, Geschäftstypen), Standort-/Adresssuchen, Kontaktdaten, Öffnungszeiten und Standardmetadaten/-ausstattung stehen.

Wenn Sie dieses Feld aktivieren, wird die Pro-Stufe ausgelöst, was zu höheren in Rechnung gestellten Kosten und einer höheren Latenz führt.
locationBias

object (LocationBias)

Eine optionale Region, um die Suchergebnisse zu beeinflussen. Wenn in textQuery ein expliziter Standort angegeben ist, wird dieser anstelle dieses Felds verwendet, um die Suchergebnisse zu beeinflussen.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SearchTextResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/maps-platform.mapstools