Places Service

PlacesService-Klasse

google.maps.places.PlacesService Klasse

Enthält Methoden zum Suchen nach Orten und zum Abrufen von Details zu einem Ort.

Zugriff durch Anrufen von const {PlacesService} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
PlacesService
PlacesService(attrContainer)
Parameter:
Erstellt eine neue Instanz von PlacesService, mit der Quellenangaben im angegebenen Container gerendert werden.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parameter:
Rückgabewert:Keiner
Ruft eine Liste von Orten basierend auf einer Telefonnummer ab. In den meisten Fällen sollte nur ein Element in der Ergebnisliste enthalten sein. Wenn die Anfrage jedoch mehrdeutig ist, können auch mehrere Ergebnisse zurückgegeben werden. Die an den Callback übergebenen PlaceResults sind Teilmengen eines vollständigen PlaceResult. Ihre App kann für jeden Ort ein detaillierteres PlaceResult abrufen, indem sie PlacesService.getDetails aufruft und die PlaceResult.place_id für den gewünschten Ort übergibt.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parameter:
Rückgabewert:Keiner
Ruft eine Liste von Orten basierend auf einem Suchstring ab. In den meisten Fällen sollte nur ein Element in der Ergebnisliste enthalten sein. Wenn die Anfrage jedoch mehrdeutig ist, können auch mehrere Ergebnisse zurückgegeben werden. Die an den Callback übergebenen PlaceResults sind Teilmengen eines vollständigen PlaceResult. Ihre App kann für jeden Ort ein detaillierteres PlaceResult abrufen, indem sie PlacesService.getDetails aufruft und die PlaceResult.place_id für den gewünschten Ort übergibt.
getDetails
getDetails(request, callback)
Parameter:
Rückgabewert:Keiner
Ruft Details zum Ort ab, der durch die angegebene placeId identifiziert wird.
nearbySearch
nearbySearch(request, callback)
Parameter:
Rückgabewert:Keiner
Ruft anhand eines Suchbegriffs oder Typs eine Liste von Orten in der Nähe eines bestimmten Ortes ab. Der Standort muss immer angegeben werden, entweder durch Übergabe eines LatLngBounds-Parameters oder von location- und radius-Parametern. Die an den Callback übergebenen PlaceResult sind Teilmengen der vollständigen PlaceResult. Ihre App kann für jeden Ort eine detailliertere PlaceResult abrufen, indem sie eine Place Details-Anfrage mit der PlaceResult.place_id für den gewünschten Ort sendet. Mit dem PlaceSearchPagination-Objekt können zusätzliche Ergebnisseiten abgerufen werden (null, wenn dies die letzte Ergebnisseite ist oder wenn es nur eine Ergebnisseite gibt).
textSearch
textSearch(request, callback)
Parameter:
Rückgabewert:Keiner
Ruft eine Liste von Orten basierend auf einem Suchstring ab (z. B. „Pizza in New York“ oder „Schuhgeschäfte in der Nähe von Ottawa“). Standortparameter sind optional. Wenn der Standort angegeben ist, werden die Ergebnisse nur auf nahegelegene Ergebnisse ausgerichtet, nicht auf Orte innerhalb des Gebiets beschränkt. Verwenden Sie textSearch, wenn Sie mit einem beliebigen String nach Orten suchen möchten und die Suchergebnisse nicht auf einen bestimmten Ort beschränken möchten. Mit dem PlaceSearchPagination-Objekt können zusätzliche Ergebnisseiten abgerufen werden (null, wenn dies die letzte Ergebnisseite ist oder wenn es nur eine Ergebnisseite gibt).

PlaceDetailsRequest-Schnittstelle

google.maps.places.PlaceDetailsRequest-Schnittstelle

Eine „Place Details“-Anfrage, die an PlacesService gesendet werden soll.
placeId
Typ:string
Die Orts-ID des Orts, für den Details angefordert werden.
fields optional
Typ:Array<string> optional
Felder, die in die Detailantwort aufgenommen werden sollen und für die eine Abrechnung erfolgt. Wenn keine Felder angegeben sind oder ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Bei Produktions-Deployments wird hiervon abgeraten. Eine Liste der Felder finden Sie unter PlaceResult. Verschachtelte Felder können mit Punktpfaden angegeben werden (z. B. "geometry.location").
language optional
Typ:string optional
Eine Sprach-ID für die Sprache, in der Details zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
region optional
Typ:string optional
Ein Regionscode für die Region des Nutzers. Das kann sich darauf auswirken, welche Fotos zurückgegeben werden, und möglicherweise auch auf andere Dinge. Für den Regionscode ist ein zweistelliger Ländercode der Top-Level-Domain (ccTLD) zulässig. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit folgenden Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch für das Land „Vereinigtes Königreich Großbritannien und Nordirland“).
sessionToken optional
Eindeutige Referenz zum Bündeln der Detailanfrage mit einer Autocomplete-Sitzung.

FindPlaceFromPhoneNumberRequest-Schnittstelle

google.maps.places.FindPlaceFromPhoneNumberRequest-Schnittstelle

Eine „Find Place from Text Search“-Anfrage, die an PlacesService.findPlaceFromPhoneNumber gesendet werden soll.
fields
Typ:Array<string>
Felder, die in die Antwort aufgenommen werden sollen und für die Kosten anfallen. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Bei Produktions-Deployments wird hiervon abgeraten. Eine Liste der Felder finden Sie unter PlaceResult. Verschachtelte Felder können mit Punktpfaden angegeben werden (z. B. "geometry.location").
phoneNumber
Typ:string
Die Telefonnummer des Orts, nach dem gesucht werden soll. Das Format muss E.164 sein.
language optional
Typ:string optional
Eine Sprach-ID für die Sprache, in der Namen und Adressen nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
locationBias optional
Typ:LocationBias optional
Die bei der Suche nach einem Ort verwendete Gewichtung. Bei den Ergebnissen werden Orte innerhalb des angegebenen LocationBias bevorzugt, sind aber nicht auf sie beschränkt.

FindPlaceFromQueryRequest-Schnittstelle

google.maps.places.FindPlaceFromQueryRequest-Schnittstelle

Eine „Find Place from Text Search“-Anfrage, die an PlacesService.findPlaceFromQuery gesendet werden soll.
fields
Typ:Array<string>
Felder, die in die Antwort aufgenommen werden sollen und für die Kosten anfallen. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Bei Produktions-Deployments wird hiervon abgeraten. Eine Liste der Felder finden Sie unter PlaceResult. Verschachtelte Felder können mit Punktpfaden angegeben werden (z. B. "geometry.location").
query
Typ:string
Die Abfrage der Anfrage. Zum Beispiel den Namen oder die Adresse eines Ortes.
language optional
Typ:string optional
Eine Sprach-ID für die Sprache, in der Namen und Adressen nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
locationBias optional
Typ:LocationBias optional
Die bei der Suche nach einem Ort verwendete Gewichtung. Bei den Ergebnissen werden Orte innerhalb des angegebenen LocationBias bevorzugt, sind aber nicht auf sie beschränkt.

PlaceSearchRequest-Schnittstelle

google.maps.places.PlaceSearchRequest-Schnittstelle

Eine „Place Search“-Anfrage, die an PlacesService gesendet werden soll.
bounds optional
Die Grenzen, innerhalb derer nach Orten gesucht werden soll. Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist.
keyword optional
Typ:string optional
Ein Begriff, der mit allen verfügbaren Feldern abgeglichen wird, einschließlich, aber nicht beschränkt auf Name, Typ und Adresse sowie Rezensionen von Kunden und sonstigen Drittanbieterinhalten.
language optional
Typ:string optional
Eine Sprach-ID für die Sprache, in der Namen und Adressen nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng|LatLngLiteral optional
Der Ort, in dessen Umgebung gesucht werden soll.
maxPriceLevel optional
Typ:number optional
Schränkt die Ergebnisse auf Orte mit dem angegebenen Preisniveau oder niedriger ein. Die zulässigen Werte liegen im Bereich zwischen 0 (am günstigsten) und 4 (am teuersten). Muss größer oder gleich minPrice sein, falls angegeben.
minPriceLevel optional
Typ:number optional
Damit werden die Ergebnisse auf Orte mit dem angegebenen Preisniveau oder höher eingeschränkt. Die zulässigen Werte liegen im Bereich zwischen 0 (am günstigsten) und 4 (am teuersten). Muss kleiner oder gleich maxPrice sein, falls angegeben.
name optional
Typ:string optional
Gleichbedeutend mit keyword. Die Werte in diesem Feld werden mit den Werten im Feld keyword kombiniert und als Teil desselben Suchstrings übergeben.
openNow optional
Typ:boolean optional
Schränkt die Ergebnisse auf Orte ein, die derzeit geöffnet sind.
radius optional
Typ:number optional
Die Entfernung vom angegebenen Ort, innerhalb derer nach Orten gesucht werden soll, in Metern. Der maximal zulässige Wert beträgt 50.000.
rankBy optional
Typ:RankBy optional
Standard:RankBy.PROMINENCE
Gibt die Ranking-Methode an, die beim Zurückgeben von Ergebnissen verwendet werden soll. Wenn rankBy auf DISTANCE festgelegt ist, müssen Sie einen location angeben. radius und bounds können in diesem Fall nicht festgelegt werden.
type optional
Typ:string optional
Sucht nach Orten des angegebenen Typs. Der Typ wird in die Sprache des Zielorts der Anfrage übersetzt und als Abfragestring verwendet. Wenn auch eine Abfrage angegeben wird, wird sie an die lokalisierte Typ-String angehängt. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Mit diesem Feld können Sie kategorische Suchanfragen unabhängig von Sprache und Region ausführen. Gültige Typen finden Sie hier.

TextSearchRequest-Schnittstelle

google.maps.places.TextSearchRequest-Schnittstelle

Eine textbasierte Suchanfrage, die an PlacesService gesendet werden soll.
bounds optional
Grenzen, die verwendet werden, um Ergebnisse bei der Suche nach Orten zu gewichten (optional). Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist. Die Ergebnisse sind nicht auf Orte innerhalb dieses Gebiets beschränkt, aber Ergebnisse innerhalb des Gebiets werden höher eingestuft.
language optional
Typ:string optional
Eine Sprach-ID für die Sprache, in der Namen und Adressen nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng|LatLngLiteral optional
Der Mittelpunkt des Bereichs, der verwendet wird, um Ergebnisse bei der Suche nach Orten zu gewichten.
query optional
Typ:string optional
Der Suchbegriff der Anfrage. Das kann beispielsweise der Name eines Orts („Eiffelturm“), eine Kategorie gefolgt vom Namen eines Orts („Pizza in New York“) oder der Name eines Orts gefolgt von einer Ortsunterscheidung („Starbucks in Sydney“) sein.
radius optional
Typ:number optional
Der Radius des Bereichs, der verwendet wird, um Ergebnisse bei der Suche nach Orten zu gewichten, in Metern.