Places Service

PlacesService-Klasse

google.maps.places.PlacesService Kurs

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

Rufe const {PlacesService} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

PlacesService
PlacesService(attrContainer)
Parameter: 
Erstellt eine neue Instanz von PlacesService, die Attributionen im angegebenen Container rendert.
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, kann es sein, dass mehrere Ergebnisse zurückgegeben werden. Die an den Callback übergebenen PlaceResults sind Teilmengen einer vollständigen PlaceResult. Ihre App kann für jeden Ort eine detailliertere PlaceResult abrufen, indem Sie PlacesService.getDetails aufrufen und die PlaceResult.place_id für den gewünschten Ort übergeben.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parameter: 
Rückgabewert:Keiner
Ruft eine Liste von Orten auf Grundlage eines Suchstrings ab. In den meisten Fällen sollte nur ein Element in der Ergebnisliste enthalten sein. Wenn die Anfrage jedoch mehrdeutig ist, kann es sein, dass mehrere Ergebnisse zurückgegeben werden. Die an den Callback übergebenen PlaceResults sind Teilmengen einer vollständigen PlaceResult. Ihre App kann für jeden Ort eine detailliertere PlaceResult abrufen, indem Sie PlacesService.getDetails aufrufen und die PlaceResult.place_id für den gewünschten Ort übergeben.
getDetails
getDetails(request, callback)
Parameter: 
Rückgabewert:Keiner
Ruft Details zum Ort ab, der durch den angegebenen placeId identifiziert wird.
nearbySearch
nearbySearch(request, callback)
Parameter: 
Rückgabewert:Keiner
Ruft eine Liste von Orten in der Nähe eines bestimmten Standorts anhand eines Suchbegriffs oder Typs ab. Der Standort muss immer angegeben werden, entweder durch Weitergabe eines LatLngBounds- oder location- und radius-Parameters. Die an den Callback übergebenen PlaceResult sind Teilmengen der vollständigen PlaceResult. Ihre App kann eine detailliertere PlaceResult für jeden Ort abrufen, indem Sie eine Place Details-Anfrage senden und die PlaceResult.place_id für den gewünschten Ort übergeben. Mit dem PlaceSearchPagination-Objekt können zusätzliche Seiten mit Ergebnissen abgerufen werden. Es ist null, wenn dies die letzte Ergebnisseite ist oder es nur eine Ergebnisseite gibt.
textSearch
textSearch(request, callback)
Parameter: 
Rückgabewert:Keiner
Hiermit wird eine Liste von Orten anhand eines Suchstrings abgerufen, z. B. „Pizza in München“ oder „Schuhgeschäfte in der Nähe von Hamburg“. Standortparameter sind optional. Wenn der Standort angegeben ist, werden die Ergebnisse nicht auf Orte innerhalb des Gebiets beschränkt, sondern es werden Ergebnisse in der Nähe bevorzugt. 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 Seiten mit Ergebnissen abgerufen werden. Es ist null, wenn dies die letzte Ergebnisseite ist oder es nur eine Ergebnisseite gibt.

PlaceDetailsRequest-Schnittstelle

google.maps.places.PlaceDetailsRequest Benutzeroberfläche

Eine „Place Details“-Abfrage, die an die 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 der Antwort mit Details enthalten sein müssen und für die in Rechnung gestellt wird. Wenn keine Felder angegeben 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 der Region des Nutzers. Das kann sich darauf auswirken, welche Fotos zurückgegeben werden können, und möglicherweise auf andere Dinge. Der Regionscode kann ein zweistelliger Wert für eine Länderspezifische Top-Level-Domain (ccTLD) sein. 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 die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).
sessionToken optional
Eindeutige Referenz, die verwendet wird, um die Detailanfrage mit einer Autocomplete-Sitzung zu bündeln.

FindPlaceFromPhoneNumberRequest-Schnittstelle

google.maps.places.FindPlaceFromPhoneNumberRequest Benutzeroberfläche

Eine Anfrage vom Typ „Find Place from Text Search“, die an PlacesService.findPlaceFromPhoneNumber gesendet werden soll.

fields
Typ:Array<string>
Felder, die in der Antwort enthalten sein müssen und für die in Rechnung gestellt wird. 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 Ortes, der gesucht werden soll. Das Format muss E.164 sein.
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der Namen und Adressen zurückgegeben werden sollen (sofern möglich). Hier finden Sie eine Liste der unterstützten Sprachen.
locationBias optional
Typ:LocationBias optional
Die Voreingenommenheit, die bei der Suche nach einem Ort verwendet wird. Das Ergebnis wird auf die angegebene LocationBias ausgerichtet, ist aber nicht darauf beschränkt.

FindPlaceFromQueryRequest-Schnittstelle

google.maps.places.FindPlaceFromQueryRequest Benutzeroberfläche

Eine Anfrage vom Typ „Find Place from Text Search“, die an PlacesService.findPlaceFromQuery gesendet werden soll.

fields
Typ:Array<string>
Felder, die in der Antwort enthalten sein müssen und für die in Rechnung gestellt wird. 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. z. B. der Name oder die Adresse eines Ortes.
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der Namen und Adressen zurückgegeben werden sollen (sofern möglich). Hier finden Sie eine Liste der unterstützten Sprachen.
locationBias optional
Typ:LocationBias optional
Die Voreingenommenheit, die bei der Suche nach einem Ort verwendet wird. Das Ergebnis wird auf die angegebene LocationBias ausgerichtet, ist aber nicht darauf beschränkt.

Schnittstelle PlaceSearchRequest

google.maps.places.PlaceSearchRequest Benutzeroberfläche

Eine Place Search-Abfrage, die an die 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 Rezension von Kunden und sonstigen Drittanbieterinhalt
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der Namen und Adressen zurückgegeben werden sollen (sofern möglich). Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng|LatLngLiteral optional
Der Ort, in dessen Umgebung nach Orten gesucht werden soll.
maxPriceLevel optional
Typ:number optional
Damit werden die Ergebnisse auf Orte im angegebenen Preisbereich oder darunter beschränkt. 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 im oder über dem angegebenen Preisniveau 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
Damit werden die Ergebnisse auf Orte beschränkt, die derzeit geöffnet sind.
radius optional
Typ:number optional
Die Entfernung in Metern vom angegebenen Standort, in der nach Orten gesucht werden soll. Der maximal zulässige Wert beträgt 50.000.
rankBy optional
Typ:RankBy optional
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
Es wird nach Orten des angegebenen Typs gesucht. Der Typ wird in die Landessprache des Zielstandorts der Anfrage übersetzt und als Suchstring verwendet. Wenn auch eine Suchanfrage angegeben wird, wird sie mit dem lokalisierten Typstring zusammengefügt. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Mit diesem Feld können Sie sprach- und regionsunabhängige kategorische Suchanfragen durchführen. Hier finden Sie eine Liste der gültigen Typen.

TextSearchRequest-Schnittstelle

google.maps.places.TextSearchRequest Benutzeroberfläche

Eine Anfrage für die Textsuche, die an die PlacesService gesendet werden soll.

bounds optional
Grenzen, die bei der Suche nach Orten verwendet werden, um die Ergebnisse zu beeinflussen (optional). Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist. Die Ergebnisse werden nicht auf die innerhalb dieser Grenzen liegenden Ergebnisse beschränkt. Ergebnisse innerhalb der Grenzen werden jedoch höher gelistet.
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der Namen und Adressen zurückgegeben werden sollen (sofern möglich). Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng|LatLngLiteral optional
Der Mittelpunkt des Gebiets, das bei der Suche nach Orten berücksichtigt wird.
query optional
Typ:string optional
Der Suchbegriff der Anfrage. Das kann beispielsweise der Name eines Orts („Eiffelturm“) oder einer Kategorie gefolgt vom Namen eines Orts („Pizza in New York“) oder der Name eines Orts gefolgt von einem Ortsdisambiguator („Starbucks in Sydney“) sein.
radius optional
Typ:number optional
Der Radius des Bereichs, der bei der Suche nach Orten verwendet wird, in Metern.
region optional
Typ:string optional
Ein Regionscode, auf den die Ergebnisse ausgerichtet werden sollen. Der Regionscode kann ein zweistelliger Wert für eine Länderspezifische Top-Level-Domain (ccTLD) sein. 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 die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).
type optional
Typ:string optional
Es wird nach Orten des angegebenen Typs gesucht. Der Typ wird in die Landessprache des Zielstandorts der Anfrage übersetzt und als Suchstring verwendet. Wenn auch eine Suchanfrage angegeben wird, wird sie mit dem lokalisierten Typstring zusammengefügt. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Mit diesem Feld können Sie sprach- und regionsunabhängige kategorische Suchanfragen durchführen. Hier finden Sie eine Liste der gültigen Typen.

RankBy-Konstanten

google.maps.places.RankBy constants

Ranking-Optionen für eine PlaceSearchRequest.

Rufe const {RankBy} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

DISTANCE Die Suchergebnisse für Orte werden nach Entfernung vom Standort sortiert.
PROMINENCE Sortiert die Ergebnisse nach ihrer Bekanntheit.

LocationBias Typdefinition

google.maps.places.LocationBias typedef

„LocationBias“ ist eine weiche Grenze oder ein Hinweis, der bei der Suche nach Orten verwendet wird. Die Ergebnisse können auch außerhalb des angegebenen Bereichs liegen. Wenn die IP-Adresse des aktuellen Nutzers als Voreinstellung verwendet werden soll, kann der String "IP_BIAS" angegeben werden. Hinweis: Wenn Sie Circle verwenden, müssen Mittelpunkt und Radius definiert sein.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

Eine Standortbeschränkung stellt eine strenge Grenze dar, die bei der Suche nach Orten verwendet wird.

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus Konstanten

google.maps.places.PlacesServiceStatus constants

Der Status, der vom PlacesService nach Abschluss der Suchanfragen zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'OK'oder google.maps.places.PlacesServiceStatus.OK

Rufe const {PlacesServiceStatus} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

INVALID_REQUEST Die Anforderung war ungültig.
NOT_FOUND Der Ort, auf den verwiesen wurde, wurde nicht gefunden.
OK Die Antwort enthält ein gültiges Ergebnis.
OVER_QUERY_LIMIT Das Anfragekontingent der Anwendung wurde überschritten.
REQUEST_DENIED Die Anwendung darf die PlacesService nicht verwenden.
UNKNOWN_ERROR Die PlacesService-Anfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.
ZERO_RESULTS Für diese Anforderung wurde kein Ergebnis gefunden.

Schnittstelle PlaceSearchPagination

google.maps.places.PlaceSearchPagination Benutzeroberfläche

Ein Objekt, mit dem zusätzliche Seiten mit Ergebnissen für „Orte“ abgerufen werden.

hasNextPage
Typ:boolean
Gibt an, ob weitere Ergebnisse verfügbar sind. true gibt an, dass es eine weitere Seite mit Ergebnissen gibt.
nextPage
nextPage()
Parameter:Keine
Rückgabewert:Keiner
Ruft die nächste Ergebnisseite ab. Es wird dieselbe Callback-Funktion verwendet, die für die erste Suchanfrage angegeben wurde.

PlaceResult-Schnittstelle

google.maps.places.PlaceResult Benutzeroberfläche

Hier werden Informationen zu einem Ort definiert.

address_components optional
Die Sammlung der Adresskomponenten für den Standort dieses Orts. Nur mit PlacesService.getDetails verfügbar.
adr_address optional
Typ:string optional
Die Darstellung der Adresse des Orts im adr-Microformat. Nur mit PlacesService.getDetails verfügbar.
aspects optional
Typ:Array<PlaceAspectRating> optional
Die bewerteten Aspekte dieses Orts basieren auf Nutzerrezensionen von Google und Zagat. Die Bewertungen erfolgen auf einer Skala von 0 bis 30.
business_status optional
Typ:BusinessStatus optional
Ein Flag, das den Betriebsstatus des Orts angibt, sofern es sich um ein Unternehmen handelt (gibt an, ob der Ort geöffnet oder vorübergehend oder dauerhaft geschlossen ist). Wenn keine Daten verfügbar sind, ist das Flag in Such- oder Detailantworten nicht vorhanden.
formatted_address optional
Typ:string optional
Die vollständige Adresse des Orts.
formatted_phone_number optional
Typ:string optional
Die Telefonnummer des Ortes, die gemäß den örtlichen Nummernkonventionen formatiert ist. Nur mit PlacesService.getDetails verfügbar.
geometry optional
Typ:PlaceGeometry optional
Die geometrischen Daten eines Ortes.
html_attributions optional
Typ:Array<string> optional
Text der Zuordnung, der für dieses Ortsergebnis angezeigt werden soll. Verfügbare html_attributions werden immer zurückgegeben, unabhängig davon, welche fields angefordert wurden, und müssen angezeigt werden.
icon optional
Typ:string optional
URL einer Bildressource, die zur Darstellung der Kategorie dieses Orts verwendet werden kann.
icon_background_color optional
Typ:string optional
Hintergrundfarbe für das Symbol eines Orts. Siehe auch PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Typ:string optional
Eine gekürzte URL zu einer Symbolmaske. Sie können auf verschiedene Symboltypen zugreifen, indem Sie am Ende eine Dateiendung anhängen (z.B. .svg oder .png).
international_phone_number optional
Typ:string optional
Die Telefonnummer des Ortes im internationalen Format. Das internationale Format umfasst den Ländercode und ein vorangestelltes Pluszeichen (+). Nur mit PlacesService.getDetails verfügbar.
name optional
Typ:string optional
Der Name des Orts. Hinweis: Bei von Nutzern eingegebenen Orten ist dies der Rohtext, wie er vom Nutzer eingegeben wurde. Bitte verwenden Sie diese Daten mit Vorsicht, da böswillige Nutzer versuchen könnten, sie als Vektor für Code-Injection-Angriffe zu verwenden (siehe http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Typ:PlaceOpeningHours optional
Hier wird festgelegt, wann der Ort geöffnet oder geschlossen ist.
permanently_closed optional
Typ:boolean optional
Gibt an, ob der Ort dauerhaft oder vorübergehend geschlossen ist. Wenn der Ort in Betrieb ist oder keine Daten verfügbar sind, ist das Flag in der Antwort nicht enthalten.
photos optional
Typ:Array<PlacePhoto> optional
Fotos dieses Orts Die Sammlung enthält bis zu zehn PlacePhoto-Objekte.
place_id optional
Typ:string optional
Eine eindeutige Kennung für den Ort.
plus_code optional
Typ:PlacePlusCode optional
Hiermit werden Open Location Codes oder Plus Codes für den Ort definiert.
price_level optional
Typ:number optional
Das Preisniveau des Orts auf einer Skala von 0 bis 4. Preisniveaus werden folgendermaßen interpretiert:
  • 0: Kostenlos
  • 1: Günstig
  • 2: Mittel
  • 3: Teuer
  • 4: Sehr teuer
rating optional
Typ:number optional
Eine Bewertung zwischen 1,0 und 5,0, die auf Nutzerrezensionen dieses Orts basiert.
reviews optional
Typ:Array<PlaceReview> optional
Eine Liste der Rezensionen zu diesem Ort. Nur mit PlacesService.getDetails verfügbar.
types optional
Typ:Array<string> optional
Ein Array von Typen für diesen Ort, z. B. ["political", "locality"] oder ["restaurant", "establishment"].
url optional
Typ:string optional
Die URL der offiziellen Google-Seite für diesen Ort. Es handelt sich dabei um die Google-eigene Seite, die die bestmöglichen Informationen zum Ort enthält. Nur mit PlacesService.getDetails verfügbar.
user_ratings_total optional
Typ:number optional
Die Anzahl der Nutzerbewertungen, die zur PlaceResult.rating dieses Orts beigetragen haben.
utc_offset optional
Typ:number optional
Der Unterschied zwischen der aktuellen Zeitzone des Orts und UTC in Minuten. In Sydney, Australien, ist es beispielsweise während der Sommerzeit 11 Stunden vor UTC. Daher ist utc_offset in diesem Fall 660. Bei Zeitzonen, die hinter UTC liegen, ist der Versatz negativ. Für Kap Verde ist beispielsweise -60 die utc_offset. Nur mit PlacesService.getDetails verfügbar.
utc_offset_minutes optional
Typ:number optional
Der Unterschied zwischen der aktuellen Zeitzone des Orts und UTC in Minuten. In Sydney, Australien, ist es beispielsweise während der Sommerzeit 11 Stunden vor UTC. Daher ist utc_offset_minutes in diesem Fall 660. Bei Zeitzonen, die hinter UTC liegen, ist der Versatz negativ. Für Kap Verde ist beispielsweise -60 die utc_offset_minutes. Nur mit PlacesService.getDetails verfügbar.
vicinity optional
Typ:string optional
Die vereinfachte Adresse des Ortes, einschließlich Straße, Hausnummer und Verwaltungseinheit, aber ohne Provinz/Bundesland, Postleitzahl oder Land. Die Google-Niederlassung in Sydney, Australien, hat z. B. den Wert "48 Pirrama Road, Pyrmont". Nur mit PlacesService.getDetails verfügbar.
website optional
Typ:string optional
Die offizielle Website des Ortes, z. B. die Startseite eines Unternehmens. Nur mit PlacesService.getDetails verfügbar.

PlaceAspectRating-Schnittstelle

google.maps.places.PlaceAspectRating Benutzeroberfläche

Hier werden Informationen zu einem Aspekt des Orts definiert, den Nutzer bewertet haben.

rating
Typ:number
Die Bewertung dieses Aspekts. Bei einzelnen Rezensionen ist dies eine Ganzzahl zwischen 0 und 3. Bei aggregierten Bewertungen eines Orts ist dies eine Ganzzahl zwischen 0 und 30.
type
Typ:string
Der Aspekttyp. Zum Beispiel "food", "decor", "service" oder "overall".

Konstanten für BusinessStatus

google.maps.places.BusinessStatus constants

Der Betriebsstatus des Orts, sofern es sich um ein Unternehmen handelt, wird in einem PlaceResult zurückgegeben. Er gibt an, ob der Ort geöffnet oder vorübergehend oder dauerhaft geschlossen ist. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an (z. B. 'OPERATIONAL' oder google.maps.places.BusinessStatus.OPERATIONAL).

Rufe const {BusinessStatus} = await google.maps.importLibrary("places") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

CLOSED_PERMANENTLY Das Unternehmen ist dauerhaft geschlossen.
CLOSED_TEMPORARILY Das Unternehmen ist vorübergehend geschlossen.
OPERATIONAL Das Unternehmen ist normal geöffnet.

PlaceGeometry-Schnittstelle

google.maps.places.PlaceGeometry Benutzeroberfläche

Hier werden Informationen zur Geometrie eines Orts definiert.

location optional
Typ:LatLng optional
Die Position des Orts.
viewport optional
Typ:LatLngBounds optional
Der bevorzugte Darstellungsbereich, wenn dieser Ort auf einer Karte angezeigt wird. Wenn der bevorzugte Darstellungsbereich für den Ort nicht bekannt ist, wird null verwendet. Nur mit PlacesService.getDetails verfügbar.

PlaceOpeningHours-Schnittstelle

google.maps.places.PlaceOpeningHours Benutzeroberfläche

Hier werden Informationen zu den Öffnungszeiten eines Orts definiert.

open_now optional
Typ:boolean optional
Gibt an, ob der Ort derzeit geöffnet ist.
periods optional
Öffnungszeiten für jeden Wochentag in chronologischer Reihenfolge, beginnend am Sonntag. Tage, an denen der Ort nicht geöffnet ist, werden nicht berücksichtigt. Nur mit PlacesService.getDetails verfügbar.
weekday_text optional
Typ:Array<string> optional
Ein Array mit sieben Strings, die für die formatierten Öffnungszeiten an den einzelnen Wochentagen stehen. Der Places-Dienst formatiert und lokalisiert die Öffnungszeiten entsprechend für die aktuelle Sprache. Die Reihenfolge der Elemente in diesem Array hängt von der Sprache ab. In einigen Sprachen beginnt die Woche mit dem Montag, in anderen mit dem Sonntag. Nur mit PlacesService.getDetails verfügbar. Bei anderen Aufrufen wird möglicherweise ein leeres Array zurückgegeben.
isOpen
isOpen([date])
Parameter: 
  • dateDate optional
Rückgabewert:boolean|undefined
Prüfen Sie, ob der Ort jetzt geöffnet ist (wenn kein Datum angegeben ist) oder am angegebenen Datum. Wenn für diesen Ort keine PlaceResult.utc_offset_minutes oder PlaceOpeningHours.periods vorhanden ist, wird undefined zurückgegeben (PlaceOpeningHours.periods ist nur über PlacesService.getDetails verfügbar). Bei dieser Methode werden keine Sonderöffnungszeiten wie Feiertagsöffnungszeiten berücksichtigt.

Schnittstelle PlaceOpeningHoursPeriod

google.maps.places.PlaceOpeningHoursPeriod Benutzeroberfläche

Hier werden strukturierte Informationen zu den Öffnungszeiten eines Orts definiert. Hinweis:Wenn ein Ort durchgängig geöffnet ist, fehlt close in der Antwort. Ist der Ort immer geöffnet, wird in der Anwendung der Zeitraum open mit day mit dem Wert 0 und time mit dem Wert "0000" dargestellt. close ist dann nicht vorhanden.

open
Die Öffnungszeiten des Orts.
close optional
Der Geschäftsschluss des Orts.

Schnittstelle PlaceOpeningHoursTime

google.maps.places.PlaceOpeningHoursTime Benutzeroberfläche

Hiermit wird festgelegt, wann ein Ort geöffnet oder geschlossen ist.

day
Typ:number
Die Wochentage als Zahl im Bereich [0, 6], beginnend mit Sonntag. 2 bedeutet z. B. Dienstag.
hours
Typ:number
Die Stunden des PlaceOpeningHoursTime.time als Zahl im Bereich [0, 23]. Diese werden in der Zeitzone des Ortes angegeben.
minutes
Typ:number
Die Minuten der PlaceOpeningHoursTime.time als Zahl im Bereich [0, 59]. Dieser Wert wird in der Zeitzone des Ortes angegeben.
time
Typ:string
Die Uhrzeit im 24-Stunden-Format „hhmm“. Die Werte liegen im Bereich ["0000", "2359"]. Die Uhrzeit wird in der Zeitzone des Ortes angegeben.
nextDate optional
Typ:number optional
Der Zeitstempel (in Millisekunden seit der Epoche, geeignet für die Verwendung mit new Date()) für das nächste Auftreten dieser Ladenöffnungszeit. Sie wird aus dem PlaceOpeningHoursTime.day der Woche, dem PlaceOpeningHoursTime.time und dem PlaceResult.utc_offset_minutes berechnet. Wenn PlaceResult.utc_offset_minutes den Wert undefined hat, hat nextDate den Wert undefined.

PlacePlusCode-Schnittstelle

google.maps.places.PlacePlusCode Benutzeroberfläche

Hiermit werden Open Location Codes oder Plus Codes für einen Ort definiert. Plus Codes können als Ersatz für Adressen verwendet werden, wenn keine Adressen vorhanden sind, z. B. wenn Gebäude keine Hausnummern oder Straßen keine Namen haben.

global_code
Typ:string
Ein Plus Code mit einem Bereich von 1/8.000stel eines Grades mal 1/8.000stel eines Grades. Beispiel: "8FVC9G8F+5W".
compound_code optional
Typ:string optional
Ein Plus Code mit einem Gebiet von 1/8.000 Grad mal 1/8.000 Grad, bei dem die ersten vier Zeichen (die Ortsvorwahl) weggelassen und durch eine Ortsbeschreibung ersetzt werden. Beispiel: "9G8F+5W Zurich, Switzerland". Wenn keine geeignete Ortschaft gefunden werden kann, um den Code zu verkürzen, wird dieses Feld weggelassen.

PlacePhoto-Schnittstelle

google.maps.places.PlacePhoto Benutzeroberfläche

Stellt ein Fotoelement eines Orts dar.

height
Typ:number
Die Höhe des Fotos in Pixeln.
html_attributions
Typ:Array<string>
Hinweistext, der für dieses Foto angezeigt werden soll.
width
Typ:number
Die Breite des Fotos in Pixeln.
getUrl
getUrl([opts])
Parameter: 
Rückgabewert:string
Gibt die Bild-URL zurück, die den angegebenen Optionen entspricht.

PhotoOptions-Schnittstelle

google.maps.places.PhotoOptions Benutzeroberfläche

Definiert Optionen für die Anforderung von Fotos.

maxHeight optional
Typ:number optional
Die maximale Höhe in Pixeln des zurückgegebenen Bilds.
maxWidth optional
Typ:number optional
Die maximale Breite in Pixeln des zurückgegebenen Bilds.

PlaceReview-Schnittstelle

google.maps.places.PlaceReview Benutzeroberfläche

Stellt eine einzelne Rezension eines Orts dar.

author_name
Typ:string
Der Name des Rezensenten.
language
Typ:string
Ein IETF-Sprachcode, der die Sprache angibt, in der diese Rezension verfasst wurde. Dieser Code enthält nur das primäre Sprach-Tag ohne sekundäres Tag für Land oder Region. Alle englischsprachigen Rezensionen erhalten z. B. das Tag 'en' und nicht „en-AU“ oder „en-UK“.
profile_photo_url
Typ:string
Eine URL zum Profilbild des Rezensenten.
relative_time_description
Typ:string
Ein String mit einer formatierten Uhrzeit, der die Rezensionszeit relativ zur aktuellen Zeit in einer für die Sprache und das Land geeigneten Form angibt. Beispiel: "a month ago"
text
Typ:string
Der Text einer Rezension.
time
Typ:number
Zeitstempel für die Rezension in Sekunden seit der Epoche.
aspects optional
Typ:Array<PlaceAspectRating> optional
Die in der Rezension bewerteten Aspekte. Die Bewertungen auf einer Skala von 0 bis 3.
author_url optional
Typ:string optional
Eine URL zum Profil des Rezensenten. Wenn das Profil des Rezensenten nicht verfügbar ist, wird undefined angezeigt.
rating optional
Typ:number optional
Die Bewertung dieser Rezension, eine Zahl zwischen 1,0 und 5,0 (einschließlich).