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.
Konstruktor | |
---|---|
PlacesService |
PlacesService(attrContainer) Parameter:
Erstellt eine neue Instanz von PlacesService , die Attributionen im angegebenen Container rendert. |
Methoden | |
---|---|
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 PlaceResult s 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 PlaceResult s 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.
Attribute | |
---|---|
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 |
Typ:
AutocompleteSessionToken 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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral 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. |
|
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 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 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.
Attribute | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral 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.
Konstanten | |
---|---|
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.
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.
Konstanten | |
---|---|
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.
Attribute | |
---|---|
hasNextPage |
Typ:
boolean Gibt an, ob weitere Ergebnisse verfügbar sind. true gibt an, dass es eine weitere Seite mit Ergebnissen gibt. |
Methoden | |
---|---|
nextPage |
nextPage() Parameter:Keine
Rückgabewert:
void 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.
Attribute | |
---|---|
address_components optional |
Typ:
Array<GeocoderAddressComponent> 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. |
|
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:
|
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. |
|
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.
Attribute | |
---|---|
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.
Konstanten | |
---|---|
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
|
Typ:
boolean optional Gibt an, ob der Ort derzeit geöffnet ist. |
periods optional |
Typ:
Array<PlaceOpeningHoursPeriod> 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. |
Methoden | |
---|---|
isOpen |
isOpen([date]) Parameter:
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.
Attribute | |
---|---|
open |
Die Öffnungszeiten des Orts. |
close optional |
Typ:
PlaceOpeningHoursTime 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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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. |
Methoden | |
---|---|
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.
Attribute | |
---|---|
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.
Attribute | |
---|---|
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. |
|
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). |