PlacesService-Klasse
google.maps.places.PlacesService
-Klasse
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 des 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 eines vollständigen PlaceResult . Ihre App kann eine detailliertere 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: Keiner
Ruft anhand eines Abfragestrings eine Liste von Orten 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 eine detailliertere 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 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 basierend auf einem Suchbegriff oder Typ ab. Der Standort muss immer angegeben werden, indem entweder die Parameter LatLngBounds oder location und radius übergeben werden. Die an den Callback übergebenen PlaceResult sind Teilmengen des 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 die Detailantwort aufgenommen werden sollen, die in Rechnung gestellt werden. 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 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. Das kann sich darauf auswirken, welche Fotos zurückgegeben werden können, und möglicherweise auch auf andere Dinge. Der Regionscode kann einen zweistelligen Wert für eine Länderspezifische Top-Level-Domain (ccTLD) enthalten. 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 aus.
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, nach dem 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
-Schnittstelle
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 gewichtet, aber nicht auf die angegebene LocationBias beschränkt. |
PlaceSearchRequest-Schnittstelle
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 Standort, in dem nach Orten gesucht werden soll. |
maxPriceLevel optional |
Typ:
number optional Damit werden die Ergebnisse auf Orte im oder unter dem angegebenen Preisniveau 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 Beschränkt die Ergebnisse auf Orte mit der angegebenen Preisstufe oder höher. 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 von dem angegebenen Standort, innerhalb dessen nach Orten gesucht werden soll. Der maximal zulässige Wert beträgt 50.000. |
rankBy optional |
Typ:
RankBy optional Standard:
RankBy.PROMINENCE Gibt die Rangfolgenmethode 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 Es wird nach Orten des angegebenen Typs gesucht. Der Typ wird in die Landessprache des Zielstandorts der Anfrage übersetzt und als Suchstring verwendet. Wird auch eine Abfrage angegeben, wird sie mit dem String des Typs „localized“ verkettet. 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, diese 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 Bereichs, der bei der Suche nach Orten berücksichtigt wird. |
query optional |
Typ:
string optional Der Suchbegriff der Anfrage. Das kann beispielsweise der Name eines Orts (z. B. „Eiffelturm“) oder einer Kategorie gefolgt vom Namen eines Orts (z. B. „Pizza in New York“) oder der Name eines Orts gefolgt von einem Ortsdisambiguator (z. B. „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 Sucht nach Orten des angegebenen Typs. 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. Die gültigen Typen finden Sie hier. |
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 |
Ortsergebnisse werden nach Entfernung vom Ort bewertet. |
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 LocationRestriction-Angabe ist eine strikte Begrenzung, die bei der Suche nach Orten verwendet werden soll.
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 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
-Schnittstelle
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 Ortes, basierend auf Nutzerrezensionen auf Google und Zagat. Die Bewertungen werden auf einer Skala von 0 bis 30 dargestellt. |
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, wird die Kennzeichnung in Such- oder Detailantworten nicht angezeigt. |
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 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 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 Definiert, wann der Ort öffnet oder schließt. |
|
Typ:
boolean optional Eine Markierung, die 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 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 in Kombination 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 Seite von Google, 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 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 660 . Bei Zeitzonen hinter UTC ist der Offset 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 für den Ort, einschließlich Straßenname, Hausnummer und Ortsteil, aber nicht 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
Definiert Informationen zu einem Aspekt des Ortes, den Nutzer bewertet haben.
Attribute | |
---|---|
rating |
Typ:
number Die Bewertung dieses Aspekts. Für einzelne 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 sie 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 funktioniert normal. |
PlaceGeometry-Schnittstelle
google.maps.places.PlaceGeometry
-Schnittstelle
Definiert Informationen zur Geometrie eines Orts.
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 für dieses Attribut null verwendet. Nur mit PlacesService.getDetails verfügbar. |
PlaceOpeningHours-Schnittstelle
google.maps.places.PlaceOpeningHours
-Benutzeroberfläche
Definiert Informationen zu den Öffnungszeiten eines Orts.
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 in Kombination mit PlacesService.getDetails verfügbar. Andere Aufrufe können ein leeres Array zurückgeben. |
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 Öffnungszeit für den Ort. |
close optional |
Typ:
PlaceOpeningHoursTime optional Der Geschäftsschluss des Orts. |
Schnittstelle PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTime
-Benutzeroberfläche
Hier 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 wird 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. 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, 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 1/8.000. Grad und dem 1/8.000. Grad eines Bereichs, in dem die ersten vier Zeichen (die Vorwahl) 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
Ein Fotoelement eines Ortes
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
-Schnittstelle
Definiert Optionen zum Anfordern 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
Eine einzelne Rezension für einen Ort
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 der formatierten „Letzte Zeit“, der die Zeit der Rezension im Verhältnis 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). |