Method: places.searchText

Orte per Textabfrage suchen

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 Textanfrage für die textbasierte Suche.
languageCode

string

Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, können Details zu einer beliebigen Sprache zurückgegeben werden. Wenn solche Details vorhanden sind, wird Englisch bevorzugt.

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

string

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, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Hinweis: Dreistellige Ländercodes werden derzeit nicht unterstützt.
rankPreference

enum (RankPreference)

So werden die Ergebnisse in der Antwort sortiert.
includedType

string

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

boolean

Wird verwendet, um die Suche auf Orte zu beschränken, die derzeit geöffnet sind. Der Standardwert ist "false".
minRating

number

Ergebnisse herausfiltern, deren durchschnittliche Nutzerbewertung streng unter diesem Grenzwert liegt. Ein gültiger Wert muss ein Gleitkommawert zwischen 0 und 5 (einschließlich) mit einer Schrittweite von 0,5 sein, d. h. [0, 0,5, 1,0, ..., 5,0] einschließlich. Die eingegebene Bewertung wird auf die nächste 0,5 aufgerundet. Bei einer Bewertung von 0,6 werden beispielsweise alle Ergebnisse mit einer Bewertung von unter 1,0 ausgeschlossen.
maxResultCount
(deprecated)

integer

Nicht mehr unterstützt: 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 die nächste Seite mit Ergebnissen in nachfolgenden Anfragen abzurufen. Wenn 0 oder kein Wert angegeben ist, wird der Standardwert 20 verwendet. Der Höchstwert beträgt 20. Höhere Werte werden implizit auf 20 umgewandelt. 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 die nächste Seite mit Ergebnissen in nachfolgenden Anfragen abzurufen. Wenn 0 oder kein Wert angegeben ist, wird der Standardwert 20 verwendet. Der Höchstwert beträgt 20. Werte über 20 werden auf 20 festgelegt. 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 dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle Parameter, die für TextSearch bereitgestellt werden, mit Ausnahme von pageToken, pageSize und maxResultCount mit dem ursprünglichen Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.
priceLevels[]

enum (PriceLevel)

Wird verwendet, um die Suche auf Orte zu beschränken, die mit bestimmten Preisniveaus gekennzeichnet sind. Nutzer können beliebige Kombinationen von Preisniveaus auswählen. Standardmäßig sind alle Preisniveaus ausgewählt.
strictTypeFiltering

boolean

Wird verwendet, um eine strenge Typfilterung für „includedType“ festzulegen. Wenn auf „true“ gesetzt, werden nur Ergebnisse desselben Typs zurückgegeben. Standardeinstellung ist „false“.
locationBias

object (LocationBias)

Die Region, in der gesucht werden soll. Dieser Standort dient als Bias, d. h., es werden möglicherweise Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben. Kann nicht zusammen mit „locationRestriction“ festgelegt werden.
locationRestriction

object (LocationRestriction)

Die Region, in der gesucht werden soll. Dieser Ort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Ortes zurückgegeben werden. Kann nicht zusammen mit „locationBias“ festgelegt werden.
evOptions

object (EVOptions)

Optional. Legt die durchsuchbaren Optionen für Elektrofahrzeuge einer Ortsanfrage fest.
routingParameters

object (RoutingParameters)

Optional. Zusätzliche Parameter für das Weiterleiten zu Ergebnissen.
searchAlongRouteParameters

object (SearchAlongRouteParameters)

Optional. Zusätzlicher Parameter-Proto für die Suche entlang einer Route.
includePureServiceAreaBusinesses

boolean

Optional. Reine Unternehmen ohne festen Standort in einem Einzugsgebiet einschließen, wenn das Feld auf „true“ gesetzt ist. Ein reines 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 physische Adresse oder keinen Standort bei Google Maps. Für diese Unternehmen werden von Places keine Felder wie location, plusCode und andere standortbezogene Felder zurückgegeben.

Antworttext

Antwort-Proto 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 Textsuchkriterien des Nutzers entsprechen.
routingSummaries[]

object (RoutingSummary)

Eine Liste mit Routenzusammenfassungen, wobei jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld places zugeordnet ist. Wenn die Zusammenfassung der Routen für einen der Orte nicht verfügbar ist, enthält sie einen leeren Eintrag. Diese Liste enthält so viele Einträge wie die Liste der Orte, falls angefordert.
contextualContents[]

object (ContextualContent)

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Eine Liste mit Kontextinhalten, wobei jeder Eintrag dem entsprechenden Ort mit demselben Index im Feld „places“ zugeordnet ist. Inhalte, die für die textQuery in der Anfrage relevant sind, werden bevorzugt. Wenn die kontextbezogenen Inhalte für einen der Orte nicht verfügbar sind, werden nicht kontextbezogene Inhalte zurückgegeben. Das Feld ist nur leer, wenn die Inhalte für diesen Ort nicht verfügbar sind. Diese Liste enthält so viele Einträge wie die Liste der Orte, falls angefordert.
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 Textanfrage wie in der Anfrage in Google Maps suchen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

RankPreference

So werden die Ergebnisse in der Antwort sortiert.

Enums
RANK_PREFERENCE_UNSPECIFIED Bei einer kategorischen Anfrage wie „Restaurants in New York City“ ist RELEVANCE die Standardeinstellung. Bei nicht kategorischen Anfragen wie „Mountain View, CA“ empfehlen wir, „rankPreference“ nicht festzulegen.
DISTANCE Sortiert die Ergebnisse nach Entfernung.
RELEVANCE Sortiert die Ergebnisse nach Relevanz. Die Sortierreihenfolge wird durch den normalen Ranking-Stack bestimmt.

LocationBias

Die Region, in der gesucht werden soll. Dieser Standort dient als Bias, d. h., es werden möglicherweise Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben.

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 die Südwestecke definiert wird. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des Rechteck-Viewports sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitenbereich. Ein rechteckiger Viewport darf nicht breiter als 180 Grad sein.
circle

object (Circle)

Ein Kreis, der durch Mittelpunkt und Radius definiert wird.

LocationRestriction

Die Region, in der gesucht werden soll. Dieser Ort dient als Einschränkung. Das bedeutet, dass keine Ergebnisse außerhalb des angegebenen Ortes 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 die Südwestecke definiert wird. rectangle.high() muss der nordöstliche Punkt des Rechteck-Viewports sein. rectangle.low() muss der südwestliche Punkt des Rechteck-Viewports sein. rectangle.low().latitude() darf nicht größer als rectangle.high().latitude() sein. Dies führt zu einem leeren Breitenbereich. Ein rechteckiger Viewport darf nicht breiter als 180 Grad sein.

EVOptions

Suchbare Optionen für Elektrofahrzeuge einer Ortsanfrage.

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

number

Optional. Die erforderliche Mindestladegeschwindigkeit in Kilowatt. Ein Ort mit einer Laderate, die niedriger als die angegebene Rate ist, wird herausgefiltert.
connectorTypes[]

enum (EVConnectorType)

Optional. Die Liste der bevorzugten Ladesteckertypen für Elektrofahrzeuge. Ein Ort, der keinen der aufgeführten Connectortypen unterstützt, wird herausgefiltert.

SearchAlongRouteParameters

Gibt eine vorab berechnete 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 gewichten. Mit den Optionen locationBias und locationRestriction können Sie zwar eine Region angeben, um die Suchergebnisse zu gewichten, mit dieser Option können Sie die Ergebnisse jedoch entlang einer Reiseroute gewichten.

Es kann nicht garantiert werden, dass die Ergebnisse auf der angegebenen Route liegen. Sie werden vielmehr innerhalb des Suchbereichs, der durch die Polylinie und optional durch locationBias oder locationRestriction definiert wird, nach minimalen Umwegzeiten vom Start- zum Zielort sortiert. Die Ergebnisse können sich auf eine alternative Route beziehen, insbesondere wenn die angegebene Polylinie keine optimale Route vom Start- zum Zielort definiert.

JSON-Darstellung 
{
  "polyline": {
    object (Polyline)
  }
}
Felder
polyline

object (Polyline)

Erforderlich. Die Routen-Polylinie.

Polyline

Eine Routenpolylinie. 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 des Linienzugs ein. Die Standardausgabe der Routes API ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encodedPolyline

string

Eine codierte Polylinie, die standardmäßig von der Routes API zurückgegeben wird. Encoder- und Decoder-Tools

ContextualContent

Experimentell: Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Inhalte, die im Kontext der Ortsanfrage stehen.

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 Ortsanfrage stehen.
photos[]

object (Photo)

Informationen (einschließlich Referenzen) zu Fotos dieses Orts, die im Kontext der Ortsanfrage 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. Begründungen beantworten die Frage, warum ein Ort für einen 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 Damit wird ein Abschnitt der Nutzerrezension hervorgehoben, der für einen Endnutzer von Interesse sein könnte. Wenn die Suchanfrage beispielsweise „Pizza aus dem Holzofen“ lautet, wird in der Begründung der Rezension der Text hervorgehoben, der für die Suchanfrage relevant ist.

JSON-Darstellung 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Felder
highlightedText

object (HighlightedText)
review

object (Review)

Die Rezension, aus der der markierte Text generiert wurde.

HighlightedText

Der Text, der durch die Begründung hervorgehoben wird. Dies ist eine Teilmenge der Rezension selbst. Das genaue Wort, das hervorgehoben werden soll, wird durch HighlightedTextRange markiert. Im Text können mehrere Wörter hervorgehoben sein.

JSON-Darstellung 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Felder
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Die Liste der Bereiche des hervorgehobenen Texts.

HighlightedTextRange

Der Bereich des hervorgehobenen 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. Begründungen für BusinessAvailabilityAttributes. Hier werden einige Attribute eines Unternehmens angezeigt, die für einen Endnutzer von Interesse 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 Lieferservice angeboten wird.
dineIn

boolean

Ob der Verzehr von Speisen und Getränken vor Ort möglich ist.