Method: places.searchNearby

Suchen Sie nach Orten in der Nähe von Standorten.

HTTP-Anfrage

POST https://places.googleapis.com/v1/places:searchNearby

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
Felder
languageCode

string

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

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.

Beachten Sie, dass dreistellige Regionscodes derzeit nicht unterstützt werden.
includedTypes[]

string

Enthaltener Ortstyp (z. B. „Restaurant“ oder „Tankstelle“) von https://developers.google.com/maps/documentation/places/web-service/place-types

Sie können bis zu 50 Typen aus Tabelle A angeben.

Wenn Typen in Konflikt stehen, d.h. ein Typ sowohl in „includedTypes“ als auch in „excludedTypes“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir z. B. {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, enthalten die zurückgegebenen Orte "restaurant" zugehörige Dienstleistungen, die nicht primär als „Restaurants“ tätig sind.
excludedTypes[]

string

Der Ortstyp (z. B. „Restaurant“ oder „Tankstelle“) wurde von https://developers.google.com/maps/documentation/places/web-service/place-types ausgeschlossen.

Sie können bis zu 50 Typen aus Tabelle A angeben.

Wenn der Kunde sowohl eingeschlossene Typen (z.B. Restaurant) als auch ausgeschlossene Typen (z.B. Café) angibt, sollte die Antwort Orte enthalten, die ein Restaurant, aber nicht ein Café sind. Die Antwort enthält Orte, die mit mindestens einem „includedTypes“ und keinem „excludedTypes“ übereinstimmen.

Wenn Typen in Konflikt stehen, d.h. ein Typ sowohl in „includedTypes“ als auch in „excludedTypes“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir z. B. {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, enthalten die zurückgegebenen Orte "restaurant" zugehörige Dienstleistungen, die nicht primär als „Restaurants“ tätig sind.
includedPrimaryTypes[]

string

Primärer Ortstyp (z. B. „Restaurant“ oder „Tankstelle“) von https://developers.google.com/maps/documentation/places/web-service/place-types aufgenommen Einem Ort kann nur ein einziger Haupttyp aus der Tabelle mit den unterstützten Typen zugeordnet sein.

Sie können bis zu 50 Typen aus Tabelle A angeben.

Falls Primärtypen in Konflikt stehen, d.h. ein Typ sowohl in „includedPrimaryTypes“ als auch in „excludedPrimaryTypes“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir z. B. {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, enthalten die zurückgegebenen Orte "restaurant" zugehörige Dienstleistungen, die nicht primär als „Restaurants“ tätig sind.
excludedPrimaryTypes[]

string

Der primäre Ortstyp (z.B. „Restaurant“ oder „Tankstelle“) wurde von https://developers.google.com/maps/documentation/places/web-service/place-types ausgeschlossen.

Sie können bis zu 50 Typen aus Tabelle A angeben.

Falls Primärtypen in Konflikt stehen, d.h. ein Typ sowohl in „includedPrimaryTypes“ als auch in „excludedPrimaryTypes“ enthalten ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Wenn ein Ortstyp mit mehreren Typeinschränkungen angegeben wird, werden nur Orte zurückgegeben, die alle Einschränkungen erfüllen. Wenn wir z. B. {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, enthalten die zurückgegebenen Orte "restaurant" zugehörige Dienstleistungen, die nicht primär als „Restaurants“ tätig sind.
maxResultCount

integer

Maximale Anzahl der zurückzugebenden Ergebnisse. Der Wert muss zwischen 1 und 20 (Standardeinstellung) liegen. Wenn die Zahl nicht festgelegt ist, wird die Obergrenze wieder erreicht. Wenn die Zahl auf negativ festgelegt ist oder den oberen Grenzwert überschreitet, wird der Fehler INVALID_ARGUMENT zurückgegeben.
locationRestriction

object (LocationRestriction)

Erforderlich. Die Region, in der gesucht werden soll.
rankPreference

enum (RankPreference)

Ranking der Ergebnisse in der Antwort

Antworttext

Antwortprototyp für „In der Nähe suchen“.

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

JSON-Darstellung 
{
  "places": [
    {
      object (Place)
    }
  ]
}
Felder
places[]

object (Place)

Eine Liste mit Orten, die die Anforderungen der Nutzer erfüllen, z. B. Ortstypen, Anzahl von Orten und bestimmte Standortbeschränkungen.

LocationRestriction

Die Region, in der gesucht werden soll.

JSON-Darstellung 
{

  // Union field type can be only one of the following:
  "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:
circle

object (Circle)

Ein durch Mittelpunkt und Radius definierter Kreis.

RankPreference

Ranking der Ergebnisse in der Antwort

Enums
RANK_PREFERENCE_UNSPECIFIED Der RankPreference-Wert ist nicht festgelegt. Standardmäßig wird der Rang nach BELIEBTHEIT verwendet.
DISTANCE Die Ergebnisse werden nach Entfernung sortiert.
POPULARITY Die Ergebnisse werden nach Beliebtheit sortiert.