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.
region optional
Typ:string optional
Ein Regionscode, auf den die Ergebnisse ausgerichtet werden sollen. 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“).
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.

RankBy-Konstanten

google.maps.places.RankBy Konstanten

Ranking-Optionen für eine PlaceSearchRequest.

Zugriff durch Anrufen von const {RankBy} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
DISTANCE Die Ergebnisse werden nach Entfernung vom Standort sortiert.
PROMINENCE Mit Ranks werden Ergebnisse nach ihrer Bedeutung platziert.

LocationBias typedef

google.maps.places.LocationBias typedef

„LocationBias“ stellt eine weiche Grenze oder einen Hinweis dar, der bei der Suche nach Orten verwendet werden soll. Die Ergebnisse können auch von außerhalb des angegebenen Bereichs stammen. Wenn Sie die IP-Adresse des aktuellen Nutzers als Bias verwenden möchten, können Sie den String "IP_BIAS" angeben. Hinweis: Wenn Sie einen Circle verwenden, müssen Sie den Mittelpunkt und den Radius definieren.

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

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

Eine LocationRestriction stellt eine strikte Grenze dar, die bei der Suche nach Orten verwendet wird.

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus-Konstanten

google.maps.places.PlacesServiceStatus Konstanten

Der Status, der von PlacesService nach Abschluss der Suche zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.places.PlacesServiceStatus.OK

Zugriff durch Anrufen von const {PlacesServiceStatus} = await google.maps.importLibrary("places").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
INVALID_REQUEST Die Anforderung war ungültig.
NOT_FOUND Der angegebene Ort wurde nicht gefunden.
OK Die Antwort enthält ein gültiges Ergebnis.
OVER_QUERY_LIMIT Die Anwendung hat ihr Anfragekontingent ü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-Schnittstelle

Ein Objekt, mit dem zusätzliche Seiten mit Ergebnissen für Orte abgerufen werden können.
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:void
Ruft die nächste Ergebnisseite ab. Verwendet dieselbe Callback-Funktion, die für die erste Suchanfrage bereitgestellt wurde.

Schnittstelle PlaceResult

google.maps.places.PlaceResult-Schnittstelle

Definiert Informationen zu einem Ort.
address_components optional
Die Sammlung von 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-Mikroformat. Nur mit PlacesService.getDetails verfügbar.
aspects optional
Typ:Array<PlaceAspectRating> optional
Die bewerteten Aspekte dieses Orts basierend auf Google- und Zagat-Nutzerrezensionen. Die Bewertungen werden auf einer Skala von 0 bis 30 angegeben.
business_status optional
Typ:BusinessStatus optional
Ein Flag, das den Öffnungsstatus 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 Orts, die gemäß den örtlichen Nummernkonventionen formatiert ist. Nur mit PlacesService.getDetails verfügbar.
geometry optional
Typ:PlaceGeometry optional
Die geometrischen Daten eines Orts.
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 die Verwendung mit dem 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 eine Dateiendung (z.B. .svg oder .png) anhängen.
international_phone_number optional
Typ:string optional
Die Telefonnummer des Orts 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 Roh-Text, wie er vom Nutzer eingegeben wurde. Seien Sie vorsichtig, wenn Sie diese Daten verwenden, da böswillige Nutzer versuchen könnten, sie als Vektor für Code-Injection-Angriffe zu nutzen (siehe http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Typ:PlaceOpeningHours optional
Definiert, wann der Ort geöffnet oder geschlossen wird.
permanently_closed optional
Typ:boolean optional
Ein Flag, das angibt, 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 vorhanden.
photos optional
Typ:Array<PlacePhoto> optional
Fotos von diesem Ort 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
Definiert Open Location Codes oder Plus Codes für den Ort.
price_level optional
Typ:number optional
Das Preisniveau des Orts auf einer Skala von 0 bis 4. Die Preisniveaus werden so 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
Die Abweichung der aktuellen Zeitzone des Orts von UTC in Minuten. Beispiel: In Sydney, Australien, ist es während der Sommerzeit 11 Stunden später als in UTC. Der utc_offset-Wert ist also 660. Bei Zeitzonen, die hinter UTC liegen, ist der Offset negativ. Für Kap Verde ist die utc_offset beispielsweise -60. Nur mit PlacesService.getDetails verfügbar.
utc_offset_minutes optional
Typ:number optional
Die Abweichung der aktuellen Zeitzone des Orts von UTC in Minuten. Beispiel: In Sydney, Australien, ist es während der Sommerzeit 11 Stunden später als in UTC. Der utc_offset_minutes-Wert ist also 660. Bei Zeitzonen, die hinter UTC liegen, ist der Offset negativ. Für Kap Verde ist die utc_offset_minutes beispielsweise -60. Nur mit PlacesService.getDetails verfügbar.
vicinity optional
Typ:string optional
Die vereinfachte Adresse des Orts, 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" für „vicinity“. Nur mit PlacesService.getDetails verfügbar.
website optional
Typ:string optional
Die offizielle Website des Ortes, z. B. die Homepage eines Unternehmens. Nur mit PlacesService.getDetails verfügbar.

PlaceAspectRating-Schnittstelle

google.maps.places.PlaceAspectRating-Schnittstelle

Definiert Informationen zu einem Aspekt des Orts, 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".

BusinessStatus-Konstanten

google.maps.places.BusinessStatus Konstanten

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

Zugriff durch Anrufen von const {BusinessStatus} = await google.maps.importLibrary("places").
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-Schnittstelle

Definiert Informationen zur Geometrie eines Orts.
location optional
Typ:LatLng optional
Die Position des Orts.
viewport optional
Typ:LatLngBounds optional
Der bevorzugte Darstellungsbereich beim Anzeigen dieses Orts auf einer Karte. Diese Property ist null, wenn der bevorzugte Viewport für den Ort nicht bekannt ist. Nur mit PlacesService.getDetails verfügbar.

PlaceOpeningHours-Schnittstelle

google.maps.places.PlaceOpeningHours-Schnittstelle

Definiert Informationen zu den Öffnungszeiten eines Orts.
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:
  • date:  Date optional
Rückgabewert:boolean|undefined
Prüfen Sie, ob der Ort jetzt (wenn kein Datum angegeben ist) oder am angegebenen Datum geöffnet ist. Wenn für diesen Ort keine PlaceResult.utc_offset_minutes oder PlaceOpeningHours.periods vorhanden sind, 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.

PlaceOpeningHoursPeriod-Schnittstelle

google.maps.places.PlaceOpeningHoursPeriod-Schnittstelle

Definiert strukturierte Informationen zu den Öffnungszeiten eines Orts. 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 Öffnungszeit für den Ort.
close optional
Die Schließzeit des Orts.

PlaceOpeningHoursTime-Schnittstelle

google.maps.places.PlaceOpeningHoursTime-Schnittstelle

Definiert, wann ein Ort geöffnet oder geschlossen wird.
day
Typ:number
Die Wochentage als Zahl im Bereich [0, 6], beginnend mit Sonntag. Beispiel: 2 bedeutet Dienstag.
hours
Typ:number
Die Stunden von PlaceOpeningHoursTime.time als Zahl im Bereich [0, 23]. Die Angabe erfolgt in der Zeitzone des Orts.
minutes
Typ:number
Die Minuten von PlaceOpeningHoursTime.time als Zahl im Bereich [0, 59]. Die Angabe erfolgt in der Zeitzone des Orts.
time
Typ:string
Die Tageszeit im 24‑Stunden-Format „hhmm“. Die Werte liegen im Bereich ["0000", "2359"]. Die Zeit wird in der Zeitzone des Orts angegeben.
nextDate optional
Typ:number optional
Der Zeitstempel (in Millisekunden seit der Epoche, geeignet für die Verwendung mit new Date()), der das nächste Vorkommen dieser PlaceOpeningHoursTime darstellt. Er 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, wird nextDate auf undefined gesetzt.

PlacePlusCode-Schnittstelle

google.maps.places.PlacePlusCode-Schnittstelle

Definiert Open Location Codes oder Plus Codes für einen Ort. 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 Vorwahl) weggelassen und durch eine Ortsbeschreibung ersetzt werden. Beispiel: "9G8F+5W Zurich, Switzerland". Wenn keine geeignete Lokalität gefunden wird, um den Code zu verkürzen, wird dieses Feld weggelassen.

PlacePhoto-Schnittstelle

google.maps.places.PlacePhoto-Schnittstelle

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-Schnittstelle

Definiert Optionen für Fotoanfragen.
maxHeight optional
Typ:number optional
Die maximale Höhe des zurückgegebenen Bildes in Pixeln.
maxWidth optional
Typ:number optional
Die maximale Breite des zurückgegebenen Bildes in Pixeln.

PlaceReview-Schnittstelle

google.maps.places.PlaceReview-Schnittstelle

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 Tag für die Sprache, nicht das sekundäre 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 der formatierten letzten Zeit, in der die Rezensionszeit relativ zur aktuellen Zeit in einer für die Sprache und das Land geeigneten Form angegeben wird. 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 Aspekte, die in der Rezension bewertet wurden. Die Bewertungen auf einer Skala von 0 bis 3.
author_url optional
Typ:string optional
Eine URL zum Profil des Rezensenten. Dieser Wert ist undefined, wenn das Profil des Rezensenten nicht verfügbar ist.
rating optional
Typ:number optional
Die Bewertung dieser Rezension, eine Zahl zwischen 1,0 und 5,0 (einschließlich).