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 ( |
Felder | |
---|---|
textQuery |
Erforderlich. Die Textabfrage für die Textsuche. |
languageCode |
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 |
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 |
Wie die Ergebnisse in der Antwort sortiert werden. |
includedType |
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 |
Wird verwendet, um die Suche auf Orte einzuschränken, die derzeit geöffnet sind. Der Standardwert ist "false". |
minRating |
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 |
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[] |
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 |
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 |
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 |
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 |
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 ( |
Felder | |
---|---|
places[] |
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 |
Felder | |
---|---|
Union-Feld Für |
|
rectangle |
Rechteckfeld, das durch die nordöstliche und die südwestliche Ecke definiert wird |
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 |
Felder | |
---|---|
Union-Feld Für |
|
rectangle |
Rechteckfeld, das durch die nordöstliche und die südwestliche Ecke definiert wird |
EVOptions
Durchsuchbare Optionen für Elektrofahrzeuge einer Ortssuchanfrage.
JSON-Darstellung |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Felder | |
---|---|
minimumChargingRateKw |
Optional. Erforderliche Mindestladeleistung in Kilowatt. Orte, deren Kosten unter dem angegebenen Tarif liegen, wird herausgefiltert. |
connectorTypes[] |
Optional. Die Liste der bevorzugten Steckertypen für Elektrofahrzeuge. Ein Ort, der keinen der aufgeführten Connector-Typen unterstützt, wird herausgefiltert. |