Places Service

PlacesService-Klasse

google.maps.places.PlacesService Klasse

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

Zugriff über const {PlacesService} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

PlacesService
PlacesService(attrContainer)
Parameter:
Erstellt eine neue Instanz von PlacesService, die Zuordnungen im angegebenen Container rendert.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parameter:
Rückgabewert:Keine
Ruft anhand einer Telefonnummer eine Liste von Orten ab. In den meisten Fällen sollte die Ergebnisliste nur ein Element enthalten. Wenn die Anfrage jedoch mehrdeutig ist, kann mehr als ein Ergebnis zurückgegeben werden. Die PlaceResults, die an den Callback übergeben werden, sind Teilmengen einer vollständigen PlaceResult. Ihre App kann ein detaillierteres PlaceResult für jeden Ort 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:Keine
Ruft eine Liste von Orten basierend auf einem Abfragestring ab. In den meisten Fällen sollte die Ergebnisliste nur ein Element enthalten. Wenn die Anfrage jedoch mehrdeutig ist, kann mehr als ein Ergebnis zurückgegeben werden. Die PlaceResults, die an den Callback übergeben werden, sind Teilmengen einer vollständigen PlaceResult. Ihre App kann ein detaillierteres PlaceResult für jeden Ort 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:Keine
Ruft Details zum Ort ab, der durch die angegebene placeId angegeben wurde.
nearbySearch
nearbySearch(request, callback)
Parameter:
Rückgabewert:Keine
Ruft basierend auf einem Keyword oder Typ eine Liste von Orten in der Nähe eines bestimmten Standorts ab. Der Standort muss immer angegeben werden, entweder durch Übergeben der Parameter LatLngBounds oder location und radius. Die an den Callback übergebenen PlaceResult-Werte 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 PlaceResult.place_id für den gewünschten Ort übergeben. Das Objekt PlaceSearchPagination kann verwendet werden, um zusätzliche Ergebnisseiten abzurufen (null, wenn dies die letzte Seite mit Ergebnissen ist oder wenn nur eine Seite mit Ergebnissen vorhanden ist).
textSearch
textSearch(request, callback)
Parameter:
Rückgabewert:Keine
Ruft anhand eines Abfragestrings eine Liste von Orten ab (z. B. „Pizza in Hamburg“ oder „Schuhgeschäfte in der Nähe von Hamburg“). Standortparameter sind optional. Wenn der Standort angegeben ist, werden die Ergebnisse nur nach Ergebnissen in der Nähe gewichtet und nicht auf Orte innerhalb des Gebiets beschränkt. Verwenden Sie textSearch, wenn Sie mit einem beliebigen String nach Orten suchen möchten oder wenn Sie die Suchergebnisse nicht auf einen bestimmten Standort beschränken möchten. Das Objekt PlaceSearchPagination kann verwendet werden, um zusätzliche Ergebnisseiten abzurufen (null, wenn dies die letzte Seite mit Ergebnissen ist oder wenn nur eine Seite mit Ergebnissen vorhanden ist).

PlaceDetailsRequest-Schnittstelle

google.maps.places.PlaceDetailsRequest-Schnittstelle

Eine „Place Details“-Abfrage, 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 einbezogen werden und in Rechnung gestellt werden. Wenn keine Felder angegeben sind oder ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt. Für Produktionsbereitstellungen wird dies nicht empfohlen. 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
Ein Sprachbezeichner 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. Dies kann sich unter anderem darauf auswirken, welche Fotos zurückgegeben werden können. Für den Regionscode kann ein zweistelliger ccTLD-Wert („Top-Level-Domain“) verwendet werden. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).
sessionToken optional
Eindeutige Referenz, die verwendet wird, um die Detailanfrage mit einer Sitzung zur automatischen Vervollständigung zu bündeln.

FindPlaceFromPhoneNumberRequest-Schnittstelle

google.maps.places.FindPlaceFromPhoneNumberRequest-Schnittstelle

Ein „Ort suchen“ aus einer Textsuchanfrage, die an PlacesService.findPlaceFromPhoneNumber gesendet werden soll.

fields
Typ:Array<string>
Felder, die in die Antwort aufgenommen werden und in Rechnung gestellt werden. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt (für Produktionsbereitstellungen wird dies nicht empfohlen). 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, nach dem gesucht werden soll. Das Format muss E.164 sein.
language optional
Typ:string optional
Ein Sprachbezeichner 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. Das Ergebnis wird nach der gegebenen LocationBias gewichtet, aber nicht darauf beschränkt.

FindPlaceFromQueryRequest

google.maps.places.FindPlaceFromQueryRequest-Schnittstelle

Ein „Ort suchen“ aus einer Textsuchanfrage, die an PlacesService.findPlaceFromQuery gesendet werden soll.

fields
Typ:Array<string>
Felder, die in die Antwort aufgenommen werden und in Rechnung gestellt werden. Wenn ['ALL'] übergeben wird, werden alle verfügbaren Felder zurückgegeben und in Rechnung gestellt (für Produktionsbereitstellungen wird dies nicht empfohlen). 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 der Name oder die Adresse eines Ortes.
language optional
Typ:string optional
Ein Sprachbezeichner 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. Das Ergebnis wird nach der gegebenen LocationBias gewichtet, aber nicht darauf beschränkt.

PlaceSearchRequest-Schnittstelle

google.maps.places.PlaceSearchRequest-Schnittstelle

Eine Place Search-Abfrage, 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
Begriff, der mit allen verfügbaren Feldern abgeglichen wird, einschließlich, aber nicht beschränkt auf Name, Typ und Adresse sowie Kundenrezensionen und andere Inhalte von Drittanbietern.
language optional
Typ:string optional
Ein Sprachbezeichner 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, um den herum nach Orten gesucht werden soll.
maxPriceLevel optional
Typ:number optional
Schränkt die Ergebnisse auf Orte auf der angegebenen Preisstufe oder darunter ein. Werte von 0 (am preisgünstigsten) bis einschließlich 4 (am teuersten) sind zulässig. Muss größer oder gleich minPrice sein, falls angegeben.
minPriceLevel optional
Typ:number optional
Beschränkt die Ergebnisse auf Orte auf der angegebenen Preisstufe oder höher. Werte von 0 (am preisgünstigsten) bis einschließlich 4 (am teuersten) sind zulässig. 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
Beschränkt die Ergebnisse auf die Orte, die derzeit geöffnet sind.
radius optional
Typ:number optional
Entfernung in Metern zum angegebenen Ort, innerhalb dessen nach Orten gesucht werden soll. Der maximal zulässige Wert beträgt 50.000.
rankBy optional
Typ:RankBy optional
Standardwert: RankBy.PROMINENCE
Gibt die Rangfolgenmethode an, die bei der Rückgabe von Ergebnissen verwendet werden soll. Wenn rankBy auf DISTANCE gesetzt ist, müssen Sie eine location angeben. radius oder bounds können nicht festgelegt werden.
type optional
Typ:string optional
Sucht nach Orten des angegebenen Typs. Der Typ wird in die lokale Sprache des Zielorts der Anfrage übersetzt und als Abfragestring verwendet. Ist auch eine Abfrage vorhanden, wird sie mit dem String des lokalisierten Typs verkettet. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Verwenden Sie dieses Feld, um sprach- und regionsunabhängige kategoriale Suchen durchzuführen. Die gültigen Typen finden Sie hier.

TextSearchRequest-Schnittstelle

google.maps.places.TextSearchRequest-Schnittstelle

Eine Textsuchanfrage, die an PlacesService gesendet wird.

bounds optional
Grenzen, die zur Gewichtung der Ergebnisse bei der Suche nach Orten verwendet werden (optional). Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist. Ergebnisse werden nicht auf Nutzer innerhalb dieser Grenzen beschränkt, Ergebnisse innerhalb dieses Bereichs haben jedoch einen höheren Rang.
language optional
Typ:string optional
Ein Sprachbezeichner 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 zur Gewichtung der Ergebnisse bei der Suche nach Orten verwendet wird.
query optional
Typ:string optional
Der Suchbegriff der Anfrage. Zum Beispiel der Name eines Ortes („Eiffelturm“), eine Kategorie gefolgt vom Namen eines Ortes („Pizza in New York“) oder der Name eines Ortes, gefolgt von einem Ortskennzeichen („Starbucks in Sydney“).
radius optional
Typ:number optional
Der Radius des Bereichs, der zur Gewichtung der Ergebnisse bei der Suche nach Orten verwendet wird, in Metern.
region optional
Typ:string optional
Ein Regionscode, nach dem die Ergebnisse gewichtet werden sollen. Für den Regionscode kann ein zweistelliger ccTLD-Wert („Top-Level-Domain“) verwendet werden. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).
type optional
Typ:string optional
Sucht nach Orten des angegebenen Typs. Der Typ wird in die lokale Sprache des Zielorts der Anfrage übersetzt und als Abfragestring verwendet. Ist auch eine Abfrage vorhanden, wird sie mit dem String des lokalisierten Typs verkettet. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Verwenden Sie dieses Feld, um sprach- und regionsunabhängige kategoriale Suchen durchzuführen. Die gültigen Typen finden Sie hier.

RankBy-Konstanten

google.maps.places.RankBy-Konstanten

Rankingoptionen für eine PlaceSearchRequest

Zugriff über const {RankBy} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

DISTANCE Die Ortsergebnisse werden nach der Entfernung zum Ort sortiert.
PROMINENCE Ortsergebnisse werden nach ihrer Wichtigkeit geordnet.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias steht für eine weiche Grenze oder einen Hinweis für die Suche nach Orten. Die Ergebnisse können von außerhalb des angegebenen Bereichs stammen. Um die IP-Adresse des aktuellen Nutzers als Gewichtung zu verwenden, kann der String "IP_BIAS" angegeben werden. Hinweis: Bei Verwendung eines Circle müssen Mittelpunkt und Radius definiert werden.

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

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction stellt eine strikte Grenze für die Suche nach Orten dar.

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus-Konstanten

google.maps.places.PlacesServiceStatus-Konstanten

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

Zugriff über const {PlacesServiceStatus} = await google.maps.importLibrary("places") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

INVALID_REQUEST Die Anforderung war unzulässig.
NOT_FOUND Der referenzierte Ort 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 ist nicht berechtigt, PlacesService zu verwenden.
UNKNOWN_ERROR Die PlacesService-Anfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie sie noch einmal ausführen.
ZERO_RESULTS Für diese Anforderung wurde kein Ergebnis gefunden.

PlaceSearchPagination-Oberfläche

google.maps.places.PlaceSearchPagination-Schnittstelle

Ein Objekt, mit dem zusätzliche Seiten von Places-Ergebnissen abgerufen werden.

hasNextPage
Typ:boolean
Gibt an, ob weitere Ergebnisse verfügbar sind. true, wenn eine weitere Ergebnisseite vorhanden ist.
nextPage
nextPage()
Parameter:Keine
Rückgabewert:Keine
Ruft die nächste Seite mit Ergebnissen ab. Verwendet dieselbe Callback-Funktion, die für die erste Suchanfrage bereitgestellt wurde.

PlaceResult-Schnittstelle

google.maps.places.PlaceResult-Schnittstelle

Definiert Informationen zu einem Ort.

address_components optional
Die Sammlung von Adresskomponenten für die Position 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 Erfahrungsberichten von Google- und Zagat-Nutzern. Die Bewertungen basieren auf einer Skala von 0 bis 30.
business_status optional
Typ:BusinessStatus optional
Eine Markierung für den Öffnungsstatus des Orts, sofern es sich um ein Unternehmen handelt. Gibt an, ob der Ort entweder vorübergehend oder dauerhaft geschlossen ist oder geöffnet 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 regionalen Nummernkonventionen formatiert ist. Nur mit PlacesService.getDetails verfügbar.
geometry optional
Typ:PlaceGeometry optional
Die geometrischen Informationen des Orts.
html_attributions optional
Typ:Array<string> optional
Hinweistext, der für dieses Places-Ergebnis angezeigt werden soll Verfügbare html_attributions werden unabhängig davon, welche fields angefordert wurden, immer zurückgegeben und müssen angezeigt werden.
icon optional
Typ:string optional
URL einer Bildressource, die zur Darstellung der Kategorie dieses Ortes verwendet werden kann.
icon_background_color optional
Typ:string optional
Hintergrundfarbe zur Verwendung mit dem Symbol eines Orts. Siehe auch PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Typ:string optional
Eine abgeschnittene 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 Orts im internationalen Format. Das internationale Format umfasst die Ländervorwahl mit einem vorangestellten Pluszeichen (+). Nur mit PlacesService.getDetails verfügbar.
name optional
Typ:string optional
Der Name des Orts. Hinweis: Im Falle von vom Nutzer eingegebenen Orten ist dies der Rohtext, wie er von ihm eingegeben wurde. Lassen Sie bei der Verwendung dieser Daten Vorsicht walten, da böswillige Nutzer versuchen könnten, sie als Vektor für Code-Injection-Angriffe zu verwenden. Weitere Informationen finden Sie unter http://en.wikipedia.org/wiki/Code_Injection.
opening_hours optional
Typ:PlaceOpeningHours optional
Legt fest, wann ein Ort geöffnet oder geschlossen wird.
permanently_closed optional
Typ:boolean optional
Eine Markierung, die angibt, ob der Ort dauerhaft oder vorübergehend geschlossen ist. Wenn der Ort betriebsbereit ist oder keine Daten verfügbar sind, fehlt das Flag in der Antwort.
photos optional
Typ:Array<PlacePhoto> optional
Fotos von diesem Ort. Die Sammlung wird bis zu zehn PlacePhoto-Objekte enthalten.
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. Preisstufen werden wie folgt interpretiert:
  • 0: kostenlos
  • 1: Günstig
  • 2: Moderat
  • 3: Teuer
  • 4: Sehr teuer
rating optional
Typ:number optional
Eine Bewertung zwischen 1,0 und 5,0, basierend auf Nutzerrezensionen zu diesem Ort.
reviews optional
Typ:Array<PlaceReview> optional
Eine Liste mit 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. Dies ist die Google-eigene Seite, die die besten verfügbaren 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 Ortes beigetragen haben.
utc_offset optional
Typ:number optional
Die Abweichung von der UTC in der aktuellen Zeitzone des Orts in Minuten. Beispiel: Sydney, Australien, liegt in der Sommerzeit 11 Stunden vor der UTC-Zeit, daher ist utc_offset 660. Bei Zeitzonen hinter der UTC ist der Offset negativ. Für Kap Verde ist utc_offset beispielsweise -60. Nur mit PlacesService.getDetails verfügbar.
utc_offset_minutes optional
Typ:number optional
Die Abweichung von der UTC in der aktuellen Zeitzone des Orts in Minuten. Beispiel: Sydney, Australien, liegt in der Sommerzeit 11 Stunden vor der UTC-Zeit, daher ist utc_offset_minutes 660. Bei Zeitzonen hinter der UTC ist der Offset negativ. Für Kap Verde ist utc_offset_minutes beispielsweise -60. Nur mit PlacesService.getDetails verfügbar.
vicinity optional
Typ:string optional
Die vereinfachte Adresse für den Ort, einschließlich Straßenname, Hausnummer und Ortsteil, aber nicht Bundesland, Postleitzahl oder Land. Für die Google-Niederlassung in Sydney, Australien, ist beispielsweise der Nachbarschaftswert "48 Pirrama Road, Pyrmont". Nur mit PlacesService.getDetails verfügbar.
website optional
Typ:string optional
Die maßgebliche Website für diesen Ort, zum Beispiel die Startseite eines Unternehmens. Nur mit PlacesService.getDetails verfügbar.

PlaceAspectRating-Schnittstelle

google.maps.places.PlaceAspectRating-Schnittstelle

Definiert Informationen über einen 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 Ortes 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 Betriebsstatus des Orts, sofern es sich um ein Unternehmen handelt, der in einem PlaceResult zurückgegeben wird. Dieses gibt an, ob der Ort betriebsbereit ist oder vorübergehend oder dauerhaft geschlossen ist. Geben Sie dazu einen Wert oder den Namen der Konstante an (Beispiel: 'OPERATIONAL' oder google.maps.places.BusinessStatus.OPERATIONAL).

Zugriff über const {BusinessStatus} = await google.maps.importLibrary("places") aufrufen. 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 funktioniert normal.

PlaceGeometry-Schnittstelle

google.maps.places.PlaceGeometry-Schnittstelle

Definiert Informationen zur Geometrie eines Ortes.

location optional
Typ:LatLng optional
Die Position des Orts.
viewport optional
Typ:LatLngBounds optional
Bevorzugter Darstellungsbereich für die Anzeige dieses Ortes auf einer Karte Diese Eigenschaft ist null, wenn der bevorzugte Darstellungsbereich für den Ort nicht bekannt ist. Nur mit PlacesService.getDetails verfügbar.

PlaceOpeningHours-Oberfläche.

google.maps.places.PlaceOpeningHours-Schnittstelle

Definiert Informationen zu den Öffnungszeiten eines Orts.

open_now optional
Typ:boolean optional
Gibt an, ob der Ort zum aktuellen Zeitpunkt geöffnet ist.
periods optional
Öffnungszeiträume für jeden Wochentag, beginnend am Sonntag, in chronologischer Reihenfolge. 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 die formatierten Öffnungszeiten für die einzelnen Wochentage darstellen. Der Places-Dienst formatiert und lokalisiert die Öffnungszeiten entsprechend der aktuellen 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 kann ein leeres Array zurückgegeben werden.
isOpen
isOpen([date])
Parameter:
  • dateDate optional
Rückgabewert:  boolean|undefined
Überprüfe, ob der Ort jetzt (wenn kein Datum liegt) oder zum angegebenen Datum geöffnet ist. Wenn für diesen Ort PlaceResult.utc_offset_minutes oder PlaceOpeningHours.periods nicht vorhanden sind, wird undefined zurückgegeben (PlaceOpeningHours.periods ist nur über PlacesService.getDetails verfügbar). Sonderöffnungszeiten, z. B. an Feiertagen, werden bei dieser Methode nicht berücksichtigt.

PlaceOpeningHoursPeriod-Oberfläche.

google.maps.places.PlaceOpeningHoursPeriod-Schnittstelle

Definiert strukturierte Informationen zu den Öffnungszeiten eines Orts. Hinweis: Wenn ein Ort immer geöffnet ist, fehlt der close-Abschnitt in der Antwort. Kunden können sich darauf verlassen, dass „Immer geöffnet“ als open-Zeitraum dargestellt wird, der day mit dem Wert 0 und time mit dem Wert "0000" und ohne close enthält.

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 des PlaceOpeningHoursTime.time als Zahl im Bereich [0, 23]. Wird in der Zeitzone des Orts gemeldet.
minutes
Typ:number
Die Minuten des PlaceOpeningHoursTime.time als Zahl im Bereich [0, 59]. Wird in der Zeitzone des Orts gemeldet.
time
Typ:string
Uhrzeit 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 (als Millisekunden seit der Epoche, geeignet zur Verwendung mit new Date()), der den nächsten Auftreten der 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, ist nextDate undefined.

PlacePlusCode-Schnittstelle

google.maps.places.PlacePlusCode-Schnittstelle

Definiert Ortscodes für offene Orte oder Plus Codes für einen Ort. Plus Codes können als Ersatz für Adressen an Orten verwendet werden, an denen sie nicht vorhanden sind, z. B. an Orten, an denen Gebäude nicht nummeriert oder Straßen nicht benannt sind.

global_code
Typ:string
Ein Plus Code mit einem 1/8.000. eines Grades mal 1/8000. eines Gradbereichs. Beispiel: "8FVC9G8F+5W".
compound_code optional
Typ:string optional
Ein Plus Code mit einem 1/8.000. eines Grades mal 1/8.000. eines Gradbereichs, wobei die ersten vier Zeichen (die Vorwahl) weggelassen und durch eine Ortsbeschreibung ersetzt werden. Beispiel: "9G8F+5W Zurich, Switzerland". Wenn kein geeigneter Ort zur Kürzung des Codes gefunden werden kann, 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 für die angegebenen Optionen zurück

PhotoOptions-Oberfläche

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 für einen Ort dar.

author_name
Typ:string
Der Name des Rezensenten.
language
Typ:string
Ein IETF-Sprachcode, der die Sprache angibt, in der diese Rezension verfasst ist. Dieser Code enthält nur das primäre Tag für die Sprache und kein sekundäres Tag für Land oder Region. Beispielsweise sind alle englischsprachigen Rezensionen mit 'en' und nicht mit „en-AU“ oder „en-UK“ gekennzeichnet.
profile_photo_url
Typ:string
Eine URL zum Profilbild des Nutzers.
relative_time_description
Typ:string
Ein String mit dem Datum der letzten Rezension, der den Zeitpunkt der Rezension im Verhältnis zum aktuellen Zeitpunkt 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, ausgedrückt in Sekunden seit 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. Der Wert ist undefined, wenn das Profil des Rezensenten nicht verfügbar ist.
rating optional
Typ:number optional
Die Bewertung der Rezension. Eine Zahl zwischen 1,0 und 5,0 (jeweils einschließlich).