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 ( |
Felder | |
---|---|
languageCode |
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 |
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[] |
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[] |
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[] |
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[] |
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 |
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 |
Erforderlich. Die Region, in der gesucht werden soll. |
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 ( |
Felder | |
---|---|
places[] |
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 |
Felder | |
---|---|
Union-Feld Für |
|
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. |