Places Service (deprecated)

PlacesService-Klasse

Klasse google.maps.places.PlacesService
Bibliothek "places"

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

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
Parameter:
Erstellt eine neue Instanz von PlacesService, die Quellenangaben im angegebenen Container rendert.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parameter:
Rückgabewert: Keiner
Ruft eine Liste von Orten anhand einer Telefonnummer ab. In den meisten Fällen sollte die Ergebnisliste nur ein Element enthalten. Wenn die Anfrage jedoch mehrdeutig ist, können 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 Abfragestring ab. In den meisten Fällen sollte die Ergebnisliste nur ein Element enthalten. Wenn die Anfrage jedoch mehrdeutig ist, können 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 eine Liste von Orten in der Nähe eines bestimmten Standorts ab, basierend auf einem Suchbegriff oder Typ. Der Standort muss immer angegeben werden, entweder durch Übergabe eines LatLngBounds- oder der Parameter location und radius. Die an den Callback übergebenen PlaceResults sind Teilmengen des 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 Objekt PlaceSearchPagination können zusätzliche Ergebnisseiten abgerufen werden. Es ist 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 anhand eines Abfragestrings ab, z. B. „Pizza in München“ oder „Schuhgeschäfte in der Nähe von Hamburg“. Standortparameter sind optional. Wenn der Standort angegeben ist, werden Ergebnisse in der Nähe bevorzugt, aber nicht auf Orte innerhalb des Bereichs beschränkt. Verwenden Sie textSearch, wenn Sie nach Orten mit einem beliebigen String suchen möchten und die Suchergebnisse nicht auf einen bestimmten Ort beschränken möchten. Mit dem Objekt PlaceSearchPagination können zusätzliche Ergebnisseiten abgerufen werden. Es ist null, wenn dies die letzte Ergebnisseite ist oder wenn es nur eine Ergebnisseite gibt.

PlaceDetailsRequest-Schnittstelle

Schnittstelle google.maps.places.PlaceDetailsRequest

Eine „Place Details“-Anfrage, die an PlacesService gesendet werden soll.
placeId
Typ: string
Die Orts-ID des Ortes, für den Details angefordert werden.
fields
optional
Typ: Array<string> optional
Felder, die in die Antwort mit Details aufgenommen werden sollen und für die Kosten anfallen. 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 Sprachkennung 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 unter anderem darauf auswirken, welche Fotos zurückgegeben werden. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) 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 gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
sessionToken
optional
Eindeutige Referenz, die verwendet wird, um die Details-Anfrage mit einer Autocomplete-Sitzung zu bündeln.

FindPlaceFromPhoneNumberRequest-Schnittstelle

Schnittstelle google.maps.places.FindPlaceFromPhoneNumberRequest

Eine Anfrage vom Typ „Find Place from Text Search“, 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 Ortes, nach dem gesucht werden soll. Das Format muss E.164 sein.
language
optional
Typ: string optional
Eine Sprachkennung 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 Gewichtung, die bei der Suche nach einem Ort verwendet wird. Bei den Ergebnissen wird der angegebene LocationBias-Wert bevorzugt, sie sind aber nicht auf ihn beschränkt.

FindPlaceFromQueryRequest-Schnittstelle

Schnittstelle google.maps.places.FindPlaceFromQueryRequest

Eine Anfrage vom Typ „Find Place from Text Search“, 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. Beispielsweise den Namen oder die Adresse eines Ortes.
language
optional
Typ: string optional
Eine Sprachkennung 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 Gewichtung, die bei der Suche nach einem Ort verwendet wird. Bei den Ergebnissen wird der angegebene LocationBias-Wert bevorzugt, aber nicht ausschließlich berücksichtigt.

PlaceSearchRequest-Schnittstelle

Schnittstelle google.maps.places.PlaceSearchRequest

Eine Place Search-Suchanfrage, 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 Rezensionen von Kunden und sonstigen Inhalten von Dritten.
language
optional
Typ: string optional
Eine Sprachkennung 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
Damit werden die Ergebnisse auf Orte innerhalb des angegebenen Bereichs eingeschrä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 mit dem angegebenen oder einem höheren Preisniveau beschrä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 vom angegebenen Standort in Metern, innerhalb derer nach Orten gesucht werden soll. Der maximal zulässige Wert beträgt 50.000.
rankBy
optional
Typ: RankBy optional
Standard: RankBy.PROMINENCE
Gibt die Rankingmethode an, die bei der Rückgabe 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 Landessprache der Zielregion der Anfrage übersetzt und als Abfragestring verwendet. Wenn auch eine Suchanfrage angegeben ist, wird sie mit dem lokalisierten Typstring verkettet. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Verwenden Sie dieses Feld, um sprach- und regionsunabhängige kategoriespezifische Suchanfragen durchzuführen. Gültige Typen finden Sie hier.

TextSearchRequest-Schnittstelle

Schnittstelle google.maps.places.TextSearchRequest

Eine Text Search-Anfrage, die an PlacesService gesendet werden soll.
bounds
optional
Grenzen, die verwendet werden, um die Ergebnisse bei der Suche nach Orten zu beeinflussen (optional). Sowohl location als auch radius werden ignoriert, wenn bounds festgelegt ist. Die Ergebnisse sind nicht auf die Ergebnisse innerhalb dieser Grenzen beschränkt, aber Ergebnisse innerhalb dieser Grenzen werden höher eingestuft.
language
optional
Typ: string optional
Eine Sprachkennung 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 bei der Suche nach Orten zur Gewichtung der Ergebnisse verwendet wird.
query
optional
Typ: string optional
Der Suchbegriff der Anfrage. Beispiele: der Name eines Ortes („Eiffelturm“), eine Kategorie gefolgt vom Namen eines Ortes („Pizza in New York“) oder der Name eines Ortes gefolgt von einer Ortsangabe zur Mehrdeutigkeitsauflösung („Starbucks in Sydney“).
radius
optional
Typ: number optional
Der Radius des Bereichs, der bei der Suche nach Orten zur Gewichtung der Ergebnisse verwendet wird, in Metern.
region
optional
Typ: string optional
Ein Regionscode, um die Ergebnisse zu beeinflussen. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) 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 gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
type
optional
Typ: string optional
Sucht nach Orten des angegebenen Typs. Der Typ wird in die Landessprache der Zielregion der Anfrage übersetzt und als Abfragestring verwendet. Wenn auch eine Suchanfrage angegeben ist, wird sie mit dem lokalisierten Typstring verkettet. Ergebnisse eines anderen Typs werden aus der Antwort entfernt. Verwenden Sie dieses Feld, um sprach- und regionsunabhängige kategoriespezifische Suchanfragen durchzuführen. Gültige Typen finden Sie hier.

RankBy-Konstanten

Konstanten google.maps.places.RankBy
Bibliothek "places"

Rankingoptionen für eine „PlaceSearchRequest“.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE Die Ergebnisse werden nach der Entfernung zum Standort sortiert.
PROMINENCE Die Ergebnisse werden nach ihrer Bekanntheit bzw. Bedeutung sortiert.

LocationBias typedef

typedef google.maps.places.LocationBias

„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|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction (typedef)

typedef google.maps.places.LocationRestriction

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

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus-Konstanten

Konstanten google.maps.places.PlacesServiceStatus
Bibliothek "places"

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

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ PlacesServiceStatusString definiert.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
INVALID_REQUEST Die Anforderung war ungültig.
NOT_FOUND Der referenzierte 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.

PlaceSearchPagination-Schnittstelle

Schnittstelle google.maps.places.PlaceSearchPagination

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: void
Ruft die nächste Ergebnisseite ab. Verwendet dieselbe Callback-Funktion, die für die erste Suchanfrage bereitgestellt wurde.

Schnittstelle PlaceResult

Schnittstelle google.maps.places.PlaceResult

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 Ortes, basierend auf Google- und Zagat-Nutzerrezensionen. Die Bewertungen erfolgen auf einer Skala von 0 bis 30.
business_status
optional
Typ: BusinessStatus optional
Ein Flag, das den Öffnungsstatus des Ortes angibt, sofern es sich um ein Unternehmen handelt. Es 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
Quellenangabe, die für dieses Places-Ergebnis 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 des 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 Ortes. Hinweis: Bei von Nutzern eingegebenen Orten ist dies der Rohtext, 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 verwenden (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 geöffnet ist oder keine Daten verfügbar sind, ist das Flag in der Antwort nicht enthalten.
photos
optional
Typ: Array<PlacePhoto> optional
Fotos dieses Ortes. 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 Ortes 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 für diesen Ort 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 Ortes beigetragen haben.
utc_offset
optional
Typ: number optional
Die Abweichung der aktuellen Zeitzone des Orts von UTC in Minuten. Beispiel: Sydney, Australien, ist während der Sommerzeit 11 Stunden vor UTC, sodass der utc_offset-Wert 660 ist. Für Zeitzonen nach UTC ist der Versatz negativ. Für Kap Verde lautet 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: Sydney, Australien, ist während der Sommerzeit 11 Stunden vor UTC, sodass der utc_offset_minutes-Wert 660 ist. Für Zeitzonen nach UTC ist der Versatz negativ. Für Kap Verde lautet die utc_offset_minutes beispielsweise -60. 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 „vicinity“-Wert "48 Pirrama Road, Pyrmont". 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

Schnittstelle google.maps.places.PlaceAspectRating

Definiert Informationen zu einem Aspekt des Ortes, den Nutzer bewertet haben.
rating
Typ: number
Die Bewertung dieses Aspekts. Bei einzelnen Rezensionen ist dies eine Ganzzahl von 0 bis 3. Bei aggregierten Bewertungen eines Ortes ist dies eine Ganzzahl von 0 bis 30.
type
Typ: string
Der Aspekttyp. Zum Beispiel "food", "decor", "service" oder "overall".

BusinessStatus-Konstanten

Konstanten google.maps.places.BusinessStatus
Bibliothek "places"

Unternehmensstatus für den Ort. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ BusinessStatusString definiert.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY Das Unternehmen ist dauerhaft geschlossen. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.
CLOSED_TEMPORARILY Das Geschäft ist vorübergehend geschlossen. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.
FUTURE_OPENING Das Unternehmen wird in Zukunft eröffnet. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.
OPERATIONAL Das Unternehmen ist in Betrieb, aber nicht unbedingt jetzt geöffnet. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

PlaceGeometry-Schnittstelle

Schnittstelle google.maps.places.PlaceGeometry

Definiert Informationen zur Geometrie eines Orts.
location
optional
Typ: LatLng optional
Die Position des Ortes.
viewport
optional
Typ: LatLngBounds optional
Der bevorzugte Darstellungsbereich, wenn dieser Ort auf einer Karte angezeigt wird. Dieses Attribut ist null, wenn der bevorzugte Darstellungsbereich für den Ort nicht bekannt ist. Nur mit PlacesService.getDetails verfügbar.

PlaceOpeningHours-Schnittstelle

Schnittstelle google.maps.places.PlaceOpeningHours

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 7 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. Andere Aufrufe geben möglicherweise ein leeres Array zurück.
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 dieser Ort keine PlaceResult.utc_offset_minutes oder PlaceOpeningHours.periods hat, wird undefined zurückgegeben (PlaceOpeningHours.periods ist nur über PlacesService.getDetails verfügbar). Diese Methode berücksichtigt keine Sonderöffnungszeiten, z. B. an Feiertagen.

PlaceOpeningHoursPeriod-Schnittstelle

Schnittstelle google.maps.places.PlaceOpeningHoursPeriod

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 des Orts.
close
optional
Typ: PlaceOpeningHoursTime optional
Die Schließzeit des Orts.

PlaceOpeningHoursTime-Schnittstelle

Schnittstelle google.maps.places.PlaceOpeningHoursTime

Definiert, wann ein Ort geöffnet oder geschlossen wird.
day
Typ: number
Die Wochentage als Zahl im Bereich [0, 6], beginnend mit Sonntag. 2 bedeutet z. B. Dienstag.
hours
Typ: number
Die Stunden von PlaceOpeningHoursTime.time als Zahl im Bereich [0, 23]. Diese werden in der Zeitzone des Ortes angegeben.
minutes
Typ: number
Die Minuten von PlaceOpeningHoursTime.time als Zahl im Bereich [0, 59]. Diese werden in der Zeitzone des Ortes angegeben.
time
Typ: string
Die Uhrzeit im 24-Stunden-Format (hhmm). Die Werte liegen im Bereich ["0000", "2359"]. Die Zeit 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()), der das nächste Auftreten dieser „PlaceOpeningHoursTime“ darstellt. Sie wird anhand des PlaceOpeningHoursTime.day der Woche, des PlaceOpeningHoursTime.time und des PlaceResult.utc_offset_minutes berechnet. Wenn PlaceResult.utc_offset_minutes den Wert undefined hat, hat nextDate den Wert undefined.

PlacePlusCode-Schnittstelle

Schnittstelle google.maps.places.PlacePlusCode

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 Bereich 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 kein geeigneter Ort gefunden wird, um den Code zu kürzen, wird dieses Feld weggelassen.

PlacePhoto-Schnittstelle

Schnittstelle google.maps.places.PlacePhoto

Stellt ein Fotoelement eines Ortes dar.
height
Typ: number
Die Höhe des Fotos in Pixeln.
html_attributions
Typ: Array<string>
Quellenangabe, die 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

Schnittstelle google.maps.places.PhotoOptions

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

Schnittstelle google.maps.places.PlaceReview

Stellt eine einzelne Rezension eines Ortes 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 Zeit, der die Zeit der Rezension 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, angegeben in Sekunden seit der UNIX-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. 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).