Method: places.searchNearby

Nach Orten in der Nähe von Standorten suchen

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 wird, können Ortsdetails einer beliebigen Sprache zurückgegeben werden, wobei Englisch bevorzugt wird, sofern solche Details vorhanden sind.

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. Dieser Parameter wird verwendet, um Ortsdetails wie den regionsspezifischen Ortsnamen (falls verfügbar) anzuzeigen. Der Parameter kann sich gemäß geltendem Recht auf die 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.

includedTypes[]

string

Ortstyp (z. B. "Restaurant" oder "Tankstelle") aus https://developers.google.com/maps/documentation/places/web-service/place-types enthalten

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn Typen in Konflikt stehen, d.h. ein Typ sowohl unter "includedTypes" als auch unter "excludedTypes" erscheint, 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 beispielsweise {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, liefern die zurückgegebenen Orte Dienstleistungen in Bezug auf „Restaurant“, agieren aber nicht in erster Linie als „Restaurants“.

excludedTypes[]

string

Ausgeschlossener Ortstyp (z. B. "restaurant" oder "gas_station") aus https://developers.google.com/maps/documentation/places/web-service/place-types.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn der Client sowohl „includedTypes“ (z.B. „restaurant“) als auch „excludedTypes“ (z.B. „Café“) bereitstellt, sollte die Antwort Orte enthalten, bei denen es sich um „Restaurant“, aber nicht „Café“ handelt. Die Antwort enthält Orte, die mit mindestens einem der einbezogenen Typen und keinem der eingeschlossenen Typen übereinstimmen.

Wenn Typen in Konflikt stehen, d.h. ein Typ sowohl unter "includedTypes" als auch unter "excludedTypes" erscheint, 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 beispielsweise {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, liefern die zurückgegebenen Orte Dienstleistungen in Bezug auf „Restaurant“, agieren aber nicht in erster Linie als „Restaurants“.

includedPrimaryTypes[]

string

Primärer Ortstyp (z.B. „Restaurant“ oder „Tankstelle“) aus https://developers.google.com/maps/documentation/places/web-service/place-types wurde aufgenommen. Ein Ort kann nur einen einzigen primären Typ aus der Tabelle der unterstützten Typen haben, die mit ihm verknüpft ist.

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn es widersprüchliche primäre Typen gibt, d.h. ein Typ sowohl unter „includedPrimaryTypes“ als auch unter „excludedPrimaryTypes“ erscheint, 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 beispielsweise {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, liefern die zurückgegebenen Orte Dienstleistungen in Bezug auf „Restaurant“, agieren aber nicht in erster Linie als „Restaurants“.

excludedPrimaryTypes[]

string

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

Es können bis zu 50 Typen aus Tabelle A angegeben werden.

Wenn es widersprüchliche primäre Typen gibt, d.h. ein Typ sowohl unter „includedPrimaryTypes“ als auch unter „excludedPrimaryTypes“ erscheint, 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 beispielsweise {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} haben, liefern die zurückgegebenen Orte Dienstleistungen in Bezug auf „Restaurant“, agieren aber nicht in erster Linie als „Restaurants“.

maxResultCount

integer

Maximale Anzahl der zurückzugebenden Ergebnisse; Der Wert muss zwischen 1 und 20 (Standardwert) liegen. Wenn die Nummer nicht festgelegt ist, wird die Obergrenze zurückgesetzt. Wenn die Zahl negativ ist oder die Obergrenze überschreitet, wird der Fehler INVALID_ARGUMENT zurückgegeben.

locationRestriction

object (LocationRestriction)

Erforderlich. Die Region, in der gesucht werden soll.

rankPreference

enum (RankPreference)

Die Rangfolge der Ergebnisse in der Antwort.

Antworttext

Antwortproto 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 von Orten, die den Nutzeranforderungen entspricht, z. B. Ortstypen, Anzahl der Orte und spezifische Standortbeschränkung.

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

Die Rangfolge der Ergebnisse in der Antwort.

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