- HTTP-Anfrage
- Anfragetext
- Antworttext
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- SearchAlongRouteParameters
- Polylinie
- ContextualContent
- Rechtfertigung
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
Ortssuche über Textabfrage
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 | |
---|---|
text |
Erforderlich. Die Textabfrage für die Textsuche. |
language |
Details zum Ort werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Details zu Orten in beliebiger Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird bevorzugt Englisch verwendet. Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport |
region |
Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden die Details zum Ort angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Dreistellige Regionscodes werden derzeit nicht unterstützt. |
rank |
Wie die Ergebnisse in der Antwort sortiert werden. |
included |
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 eingeschlossener Typ unterstützt. |
open |
Damit wird die Suche auf Orte beschränkt, die derzeit geöffnet sind. Der Standardwert ist "false". |
min |
Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung unter diesem Grenzwert liegt. Ein gültiger Wert muss ein Gleitkommawert zwischen 0 und 5 (einschließlich) mit einer Taktfrequenz von 0,5 sein, d. h. [0, 0,5, 1,0, …, 5,0] einschließlich. Die Eingabebewertung wird auf die nächste 0,5 aufgerundet. Bei einer Bewertung von 0,6 werden beispielsweise alle Ergebnisse mit einer Bewertung von weniger als 1,0 entfernt. |
maxResultCount |
Verworfen. 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 |
page |
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 |
page |
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 Parameter außer |
price |
Damit wird die Suche auf Orte beschränkt, die als bestimmte Preisstufen gekennzeichnet sind. Nutzer können beliebige Kombinationen von Preisstufen auswählen. Standardmäßig sind alle Preisstufen ausgewählt. |
strict |
Wird verwendet, um eine strenge Typfilterung für „includedType“ festzulegen. Wenn diese Option auf „wahr“ gesetzt ist, werden nur Ergebnisse desselben Typs zurückgegeben. Standardeinstellung: „false“. |
location |
Die Region, in der gesucht werden soll. Dieser Standort dient als Voreinstellung. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können. Kann nicht zusammen mit „locationRestriction“ festgelegt werden. |
location |
Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden. Kann nicht zusammen mit „locationBias“ festgelegt werden. |
ev |
Optional. Legen Sie die Optionen für die Suchergebnisse für Elektrofahrzeuge einer Suchanfrage für Orte fest. |
routing |
Optional. Zusätzliche Parameter für die Weiterleitung zu Ergebnissen. |
search |
Optional. Zusätzliche Parameter für die Suche entlang einer Route. |
include |
Optional. Fügen Sie Unternehmen ohne festen Standort in einem Einzugsgebiet hinzu, wenn das Feld auf „true“ gesetzt ist. Ein Unternehmen ohne festen Standort in einem Einzugsgebiet ist ein Unternehmen, das Kunden vor Ort besucht oder einen Lieferservice hat, aber an seiner Geschäftsadresse keine Kunden empfängt. Dazu gehören z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben keine Adresse oder keinen Standort auf Google Maps. Für diese Unternehmen werden keine Felder wie |
Antworttext
Antwort-Prototyp für places.searchText.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "places": [ { object ( |
Felder | |
---|---|
places[] |
Eine Liste von Orten, die den Suchkriterien des Nutzers entsprechen. |
routing |
Eine Liste von Routenzusammenfassungen, bei der jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld |
contextual |
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Eine Liste mit kontextbezogenen Inhalten, bei der jeder Eintrag dem entsprechenden Ort im selben Index im Feld „Orte“ zugeordnet ist. Vorzugsweise werden Inhalte verwendet, die für die |
next |
Ein Token, das als |
search |
Über einen Link kann der Nutzer mit derselben Textabfrage wie in der Anfrage in Google Maps suchen. |
RankPreference
Wie die Ergebnisse in der Antwort sortiert werden.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
Bei einer kategorischen Suchanfrage wie „Restaurants in New York City“ ist RELEVANZ standardmäßig festgelegt. Bei nicht kategorischen Suchanfragen wie „Mountain View, CA“ empfehlen wir, die Einstellung „rankPreference“ deaktiviert zu lassen. |
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 Voreinstellung. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld Für |
|
rectangle |
Ein Rechteck, das durch die Nordost- und Südwestecke definiert ist. |
circle |
Ein Kreis, der durch Mittelpunkt und Radius definiert ist. |
LocationRestriction
Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld Für |
|
rectangle |
Ein Rechteck, das durch die Nordost- und Südwestecke definiert ist. |
EVOptions
Suchbare Optionen für Elektrofahrzeuge einer Suchanfrage für Orte.
JSON-Darstellung |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Felder | |
---|---|
minimum |
Optional. Mindestens erforderliche Ladeleistung in Kilowatt. Ein Ort mit einem Ladepreis, der unter dem angegebenen Preis liegt, wird herausgefiltert. |
connector |
Optional. Die Liste der bevorzugten Ladesteckertypen. Orte, die keinen der aufgeführten Connectortypen unterstützen, werden herausgefiltert. |
SearchAlongRouteParameters
Gibt eine vordefinierte Polylinie aus der Routes API an, die die zu durchsuchende Route definiert. Die Suche entlang einer Route ähnelt der Verwendung der Anfrageoption locationBias
oder locationRestriction
, um die Suchergebnisse zu beeinflussen. Mit den Optionen locationBias
und locationRestriction
können Sie jedoch eine Region angeben, um die Suchergebnisse zu beeinflussen. Mit dieser Option können Sie die Ergebnisse entlang einer Reiseroute beeinflussen.
Die Ergebnisse befinden sich nicht unbedingt entlang der angegebenen Route, sondern werden im Suchbereich, der durch die Polylinie und optional durch locationBias
oder locationRestriction
definiert ist, anhand der minimalen Umwege vom Start- zum Zielort sortiert. Die Ergebnisse können entlang einer alternativen Route liegen, insbesondere wenn die angegebene Polylinie keine optimale Route vom Start- zum Zielort definiert.
JSON-Darstellung |
---|
{
"polyline": {
object ( |
Felder | |
---|---|
polyline |
Erforderlich. Die Polylinie der Route. |
Polyline
Eine Polylinie für eine Route. Es wird nur eine codierte Polylinie unterstützt, die als String übergeben werden kann und eine Komprimierung mit minimalen Verlusten umfasst. Dies ist die Standardausgabe der Routes API.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld polyline_type . Kapselt den Typ des Polyliniens ein. Die Standardeinstellung für die Routes API-Ausgabe ist encoded_polyline . Für polyline_type ist nur einer der folgenden Werte zulässig: |
|
encoded |
Eine codierte Polylinie, wie sie standardmäßig von der Routes API zurückgegeben wird. Weitere Informationen finden Sie in den Tools Encoder und Decoder. |
ContextualContent
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Inhalte, die zum Kontext der Ortsabfrage passen.
JSON-Darstellung |
---|
{ "reviews": [ { object ( |
Felder | |
---|---|
reviews[] |
Liste der Rezensionen zu diesem Ort, die im Kontext der Ortsabfrage stehen. |
photos[] |
Informationen (einschließlich Verweise) zu Fotos dieses Orts im Kontext der Ortsabfrage. |
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. Begründungen beantworten die Frage, warum ein Ort für einen Endnutzer interessant sein könnte.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld Für |
|
review |
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
business |
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 Hier wird ein Abschnitt der Rezension hervorgehoben, der für einen Endnutzer interessant ist. Wenn die Suchanfrage beispielsweise „Holzofenpizza“ lautet, wird in der Begründung der Rezension der für die Suchanfrage relevante Text hervorgehoben.
JSON-Darstellung |
---|
{ "highlightedText": { object ( |
Felder | |
---|---|
highlighted |
|
review |
Die Rezension, aus der der markierte Text generiert wurde. |
HighlightedText
Der durch die Ausrichtung hervorgehobene Text. Dies ist ein Teil der Rezension selbst. Das genaue Wort, das hervorgehoben werden soll, wird durch den HighlightedTextRange gekennzeichnet. Es können mehrere Wörter im Text hervorgehoben werden.
JSON-Darstellung |
---|
{
"text": string,
"highlightedTextRanges": [
{
object ( |
Felder | |
---|---|
text |
|
highlighted |
Die Liste der Bereiche des hervorgehobenen Texts. |
HighlightedTextRange
Der Bereich des markierten Texts.
JSON-Darstellung |
---|
{ "startIndex": integer, "endIndex": integer } |
Felder | |
---|---|
start |
|
end |
|
BusinessAvailabilityAttributesJustification
Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Begründungen für BusinessAvailabilityAttributes Hier sehen Sie einige Attribute eines Unternehmens, die für einen Endnutzer interessant sein könnten.
JSON-Darstellung |
---|
{ "takeout": boolean, "delivery": boolean, "dineIn": boolean } |
Felder | |
---|---|
takeout |
Ob ein Ort Gerichte zum Mitnehmen anbietet. |
delivery |
Ob ein Unternehmen einen Lieferservice anbietet. |
dine |
Ob ein Lokal Speisen und Getränke zum Verzehr vor Ort anbietet. |