- HTTP-Anfrage
- Anfragetext
- Antworttext
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- Begründung
- ReviewJustification (Begründung)
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
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 |
Eingestellt: Verwenden Sie stattdessen Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden können. Wenn die Anzahl der verfügbaren Ergebnisse größer als Wenn sowohl |
pageSize |
Optional. Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden können. Wenn die Anzahl der verfügbaren Ergebnisse größer als Wenn sowohl |
pageToken |
Optional. Ein Seitentoken, das von einem vorherigen TextSearch-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle für TextSearch bereitgestellten Parameter mit Ausnahme von |
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“.
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "places": [ { object ( |
Felder | |
---|---|
places[] |
Eine Liste von Orten, die den Kriterien der Textsuche des Nutzers entsprechen. |
contextualContents[] |
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Eine Liste mit kontextbezogenen Inhalten, in der jeder Eintrag dem entsprechenden Ort im selben Index im Feld „Places“ zugeordnet ist. Die Inhalte, die für die |
nextPageToken |
Ein Token, das als |
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. |
ContextualContent
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Inhalt im Kontext der Ortsanfrage
JSON-Darstellung |
---|
{ "reviews": [ { object ( |
Felder | |
---|---|
reviews[] |
Liste der Rezensionen zu diesem Ort, die mit der Ortsanfrage zusammenhängen. |
photos[] |
Informationen (einschließlich Quellenangaben) zu Fotos dieses Orts, die mit der Ortsanfrage verknüpft sind. |
justifications[] |
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. Mit Begründungen wird die Frage beantwortet, warum ein Ort für Endnutzer von Interesse sein könnte.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld Für |
|
reviewJustification |
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
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 für die Endanwendenden interessant ist. Wenn die Suchanfrage beispielsweise „feuerholzpizza“ lautet, hebt die Begründung der Rezension den für die Suchanfrage relevanten Text hervor.
JSON-Darstellung |
---|
{ "highlightedText": { object ( |
Felder | |
---|---|
highlightedText |
|
review |
Die Rezension, aus der der markierte Text generiert wird. |
HighlightedText
Der von der Begründung hervorgehobene Text. Dies ist ein Teilbereich der Rezension selbst. Das genaue Wort, das markiert werden soll, ist durch HighlightedTextRange gekennzeichnet. Möglicherweise sind mehrere Wörter im Text hervorgehoben.
JSON-Darstellung |
---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
Felder | |
---|---|
text |
|
highlightedTextRanges[] |
Die Liste der Bereiche des markierten Textes. |
HighlightedTextRange
Der Bereich des markierten Texts.
JSON-Darstellung |
---|
{ "startIndex": integer, "endIndex": integer } |
Felder | |
---|---|
startIndex |
|
endIndex |
|
BusinessAvailabilityAttributesJustification
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. BusinessAvailabilityAttributes-Begründungen. Hier sehen Sie einige Attribute eines Unternehmens, die für Endnutzer von Interesse sein könnten.
JSON-Darstellung |
---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
Felder | |
---|---|
takeout |
Gibt an, ob an einem Ort Essen zum Mitnehmen angeboten wird. |
delivery |
Gibt an, ob ein Ort einen Lieferservice anbietet. |
dineIn |
Gibt an, ob an einem Ort Verzehr vor Ort angeboten wird |