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.