Method: places.searchText

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 (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)
  },
  "routingParameters": {
    object (RoutingParameters)
  },
  "searchAlongRouteParameters": {
    object (SearchAlongRouteParameters)
  },
  "includePureServiceAreaBusinesses": boolean
}
Felder
textQuery

string

Erforderlich. Die Textabfrage für die Textsuche.
languageCode

string

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

Dreistellige Regionscodes werden derzeit nicht unterstützt.
rankPreference

enum (RankPreference)

Wie die Ergebnisse in der Antwort sortiert werden.
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

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

number

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(Obergrenze) aufgerundet. Bei einer Bewertung von 0,6 werden beispielsweise alle Ergebnisse mit einer Bewertung unter 1,0 ausgeschlossen.
maxResultCount
(deprecated)

integer

Verworfen. Verwenden Sie stattdessen pageSize.

Die maximale Anzahl von Ergebnissen pro Seite, die zurückgegeben werden können. 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 die nächste Ergebnisseite abzurufen. Wenn „0“ oder kein Wert angegeben ist, wird der Standardwert „20“ verwendet. Der Maximalwert ist 20. Werte über 20 werden in 20 erzwungen. 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 können. 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 die nächste Ergebnisseite abzurufen. Wenn „0“ oder kein Wert angegeben ist, wird der Standardwert „20“ verwendet. Der Maximalwert ist 20. Werte über 20 werden 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. 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 pageToken, pageSize und maxResultCount, die für „TextSearch“ bereitgestellt werden, mit dem ursprünglichen 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 beliebige Kombinationen von Preisstufen auswählen. Standardmäßig werden alle Preisstufen ausgewählt.
strictTypeFiltering

boolean

Wird verwendet, um die strikte Typfilterung für „includedType“ festzulegen. Wenn diese Option auf „wahr“ gesetzt ist, werden nur Ergebnisse desselben Typs zurückgegeben. Standardeinstellung: „false“.
locationBias

object (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. 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 Optionen für die Suchergebnisse für Elektrofahrzeuge einer Suchanfrage für Orte fest.
routingParameters

object (RoutingParameters)

Optional. Zusätzliche Parameter für die Weiterleitung an Ergebnisse.
searchAlongRouteParameters

object (SearchAlongRouteParameters)

Optional. Zusätzliche Parameter für die Suche entlang einer Route.
includePureServiceAreaBusinesses

boolean

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. z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben keine Adresse oder keinen Standort auf Google Maps. Für diese Unternehmen werden keine Felder wie location, plusCode und andere standortbezogene Felder zurückgegeben.

Antworttext

Antwort-Prototyp für places.searchText.

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

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

object (Place)

Eine Liste von Orten, die den Suchkriterien des Nutzers entsprechen.
routingSummaries[]

object (RoutingSummary)

Eine Liste von Routenzusammenfassungen, bei der jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Routenplanung für einen der Orte nicht verfügbar ist, enthält sie einen leeren Eintrag. Diese Liste enthält auf Anfrage genauso viele Einträge wie die Liste der Orte.
contextualContents[]

object (ContextualContent)

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 textQuery in der Anfrage relevant sind. Wenn für einen der Orte kein kontextbezogener Inhalt verfügbar ist, wird nicht-kontextbezogener Inhalt zurückgegeben. Es ist nur dann leer, wenn die Inhalte für diesen Ort nicht verfügbar sind. Diese Liste enthält bei Bedarf so viele Einträge 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 oder leer ist, sind keine weiteren Seiten vorhanden.
searchUri

string

Über einen Link kann der Nutzer mit derselben Textabfrage wie in der Anfrage in Google Maps suchen.

RankPreference

Ranking der Ergebnisse in der Antwort

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. 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 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 Rechteck, das durch die Nordost- und Südwestecke definiert ist. rectangle.high() muss der nordöstliche Punkt des rechteckigen Ansichtsbereichs sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Darstellungsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Ansichtsbereich darf nicht breiter als 180 Grad sein.
circle

object (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 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 Rechteck, das durch die Nordost- und Südwestecke definiert ist. rectangle.high() muss der nordöstliche Punkt des rechteckigen Ansichtsbereichs sein. rectangle.low() muss der südwestliche Punkt des rechteckigen Ansichtsbereichs sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitengradbereich. Ein rechteckiger Ansichtsbereich darf nicht breiter als 180 Grad sein.

EVOptions

Suchbare Optionen für Elektrofahrzeuge einer Suchanfrage für Orte.

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

number

Optional. Mindestens erforderliche Ladeleistung in Kilowatt. Ein Ort mit einem Ladepreis unter dem angegebenen Preis wird herausgefiltert.
connectorTypes[]

enum (EVConnectorType)

Optional. Die Liste der bevorzugten Anschlusstypen für Elektrofahrzeuge. Orte, die keinen der aufgeführten Connectortypen unterstützen, werden herausgefiltert.

SearchAlongRouteParameters

Gibt eine vordefinierte Polylinie aus der Routes API an, die die zu suchende 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 zur Gewichtung der Suchergebnisse angeben. Mit dieser Option können Sie die Ergebnisse jedoch gemäß der Fahrtroute gewichten.

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 (Polyline)
  }
}
Felder
polyline

object (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 polyline_type can be only one of the following:
  "encodedPolyline": string
  // End of list of possible types for union field polyline_type.
}
Felder
Union-Feld polyline_type. Kapselt den Typ der Polylinie ein. Die Standardeinstellung für die Routes API-Ausgabe ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encodedPolyline

string

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 (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Felder
reviews[]

object (Review)

Liste der Rezensionen zu diesem Ort, die im Kontext der 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 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 (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Felder
highlightedText

object (HighlightedText)
review

object (Review)

Die Rezension, aus der der markierte Text generiert wird.

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 (HighlightedTextRange)
    }
  ]
}
Felder
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Die Liste der Bereiche des markierten Textes.

HighlightedTextRange

Der Bereich des markierten Texts.

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 ein Ort Gerichte zum Mitnehmen anbietet.
delivery

boolean

Ob ein Ort einen Lieferservice anbietet.
dineIn

boolean

Ob ein Lokal Speisen und Getränke zum Verzehr vor Ort anbietet.