Place

Place-Klasse

google.maps.places.Place Klasse

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

Place
Place(options)
Parameter:
searchByText
searchByText(request)
Parameter:
Rückgabewert:  Promise<{places:Array<Place>}>
Textabfragebasierte Ortssuche
accessibilityOptions
Eingabehilfeoptionen für diesen Ort undefined, wenn die Daten zur Barrierefreiheit nicht vom Server abgerufen wurden.
addressComponents
Typ:Array<AddressComponent> optional
Die Sammlung von Adresskomponenten für die Position dieses Orts. Leeres Objekt, wenn keine Adressdaten vorhanden sind. undefined, wenn die Adressdaten nicht vom Server abgerufen wurden.
adrFormatAddress
Typ:string optional
Die Darstellung der Adresse des Orts im adr-Mikroformat.
attributions
Typ:Array<Attribution> optional
Hinweistext, der für dieses Places-Ergebnis angezeigt werden soll
businessStatus
Typ:BusinessStatus optional
Der Betriebsstatus des Standorts. null, wenn kein Status bekannt ist. undefined, wenn die Statusdaten nicht vom Server geladen wurden.
displayName
Typ:string optional
Anzeigename des Standorts null, wenn kein Name vorhanden ist. undefined, wenn die Namensdaten nicht vom Server geladen wurden.
editorialSummary
Typ:string optional
Die redaktionelle Zusammenfassung für diesen Ort. null, wenn keine redaktionelle Zusammenfassung vorhanden ist. undefined, wenn dieses Feld noch nicht angefordert wurde.
editorialSummaryLanguageCode
Typ:string optional
Die Sprache der redaktionellen Zusammenfassung für diesen Ort. null, wenn keine redaktionelle Zusammenfassung vorhanden ist. undefined, wenn dieses Feld noch nicht angefordert wurde.
formattedAddress
Typ:string optional
Die vollständige Adresse des Standorts.
googleMapsURI
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.
hasCurbsidePickup
Typ:boolean optional
Ob es für einen Ort eine Abholung vor dem Laden anbietet. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
hasDelivery
Typ:boolean optional
Ob für einen Ort eine Lieferung verfügbar ist. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
hasDineIn
Typ:boolean optional
Ob ein Ort bereits gegessen hat. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
hasTakeout
Typ:boolean optional
Ob es an einem Ort Essen zum Mitnehmen gibt. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
iconBackgroundColor
Typ:string optional
Der standardmäßige Hex-Farbcode für die Kategorie des Ortes.
id
Typ:string
Die eindeutige Orts-ID.
internationalPhoneNumber
Typ:string optional
Die Telefonnummer des Orts im internationalen Format. Das internationale Format umfasst die Ländervorwahl mit einem vorangestellten Pluszeichen (+).
isReservable
Typ:boolean optional
Gibt an, ob ein Ort reservierbar ist. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
location
Typ:LatLng optional
Die Position des Orts.
nationalPhoneNumber
Typ:string optional
Die Telefonnummer des Orts, die gemäß den regionalen Konventionen für die Nummer formatiert ist.
photos
Typ:Array<Photo> optional
Fotos von diesem Ort. Die Sammlung wird bis zu zehn Photo-Objekte enthalten.
plusCode
Typ:PlusCode optional
priceLevel
Typ:PriceLevel optional
Das Preisniveau des Orts. Diese Eigenschaft kann einen der folgenden Werte zurückgeben:
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Typ:number optional
Eine Bewertung zwischen 1,0 und 5,0, basierend auf Nutzerrezensionen zu diesem Ort.
regularOpeningHours
Typ:OpeningHours optional
requestedLanguage
Typ:string optional
Die für diesen Ort angeforderte Sprache.
requestedRegion
Typ:string optional
Die angeforderte Region für diesen Ort.
reviews
Typ:Array<Review> optional
Eine Liste mit Rezensionen für diesen Ort.
servesBeer
Typ:boolean optional
Ob an einem Ort Bier ausgeschenkt wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesBreakfast
Typ:boolean optional
Gibt an, ob an einem Ort Frühstück angeboten wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesBrunch
Typ:boolean optional
Ob in einem Ort Brunch angeboten wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesDinner
Typ:boolean optional
Gibt an, ob an einem Ort Abendessen angeboten wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesLunch
Typ:boolean optional
Ob an einem Ort Mittagessen serviert wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesVegetarianFood
Typ:boolean optional
Gibt an, ob an einem Ort vegetarische Gerichte angeboten werden. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
servesWine
Typ:boolean optional
Ob an einem Ort Wein ausgeschenkt wird. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist. Gibt „undefiniert“ zurück, wenn dieses Feld noch nicht angefordert wurde.
svgIconMaskURI
Typ:string optional
URI für die Ressource der SVG-Bildmaske, die zur Darstellung der Kategorie eines Ortes verwendet werden kann.
types
Typ:Array<string> optional
Ein Array von Typen für diesen Ort, z. B. ["political", "locality"] oder ["restaurant", "establishment"].
userRatingCount
Typ:number optional
Die Anzahl der Nutzerbewertungen, die zur Place.rating dieses Ortes beigetragen haben.
utcOffsetMinutes
Typ:number optional
Die Abweichung von der UTC in der aktuellen Zeitzone des Orts in Minuten. So liegt beispielsweise bei der Sommerzeit die australische Normalzeit GMT +10 11 Stunden vor der UTC. Daher ist der utc_offset_minutes auf 660. Bei Zeitzonen hinter der UTC ist der Offset negativ. Für Kap Verde ist utc_offset_minutes beispielsweise -60.
viewport
Typ:LatLngBounds optional
Bevorzugter Darstellungsbereich für die Anzeige dieses Ortes auf einer Karte
websiteURI
Typ:string optional
Die maßgebliche Website für diesen Ort, zum Beispiel die Startseite eines Unternehmens.
openingHours
Typ:OpeningHours optional
fetchFields
fetchFields(options)
Parameter:
Rückgabewert:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parameter:
  • dateDate optional
Rückgabewert:  Promise<Date optional>
Berechnet das Datum, das die nächste OpeningHoursTime darstellt. Gibt undefiniert zurück, wenn die Daten für die Berechnung des Ergebnisses nicht ausreichen oder dieser Ort nicht betriebsbereit ist.
BetaisOpen
isOpen([date])
Parameter:
  • dateDate optional Die Standardeinstellung ist „jetzt“.
Rückgabewert:  Promise<boolean optional>
Prüfe, ob der Ort zu diesem Zeitpunkt geöffnet ist. Wird mit undefined aufgelöst, wenn die bekannten Daten für den Standort nicht ausreichen, um dies zu berechnen, z.B. wenn die Öffnungszeiten nicht registriert sind.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Object ist ein JSON-Objekt mit allen angeforderten Ortseigenschaften.

PlaceOptions-Schnittstelle

google.maps.places.PlaceOptions-Schnittstelle

Optionen zum Erstellen eines Orts.

id
Typ:string
Die eindeutige Orts-ID.
requestedLanguage 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.
requestedRegion 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“).

AccessibilityOptions-Klasse

google.maps.places.AccessibilityOptions Klasse

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

hasWheelchairAccessibleEntrance
Typ:boolean optional
Ob ein Ort einen rollstuhlgerechten Eingang hat. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist.
hasWheelchairAccessibleParking
Typ:boolean optional
Gibt an, ob für einen Ort rollstuhlgerechte Parkplätze vorhanden sind. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist.
hasWheelchairAccessibleRestroom
Typ:boolean optional
Ob ein Ort eine rollstuhlgerechte Toilette hat. Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist.
hasWheelchairAccessibleSeating
Typ:boolean optional
Ob ein Ort rollstuhlgerechte Sitzgelegenheiten bietet Gibt "true" oder "false" zurück, wenn der Wert bekannt ist. Gibt "null" zurück, wenn der Wert unbekannt ist.

AddressComponent-Klasse

google.maps.places.AddressComponent Klasse

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

longText
Typ:string optional
Der vollständige Text der Adresskomponente.
shortText
Typ:string optional
Der abgekürzte Text der angegebenen Adresskomponente.
types
Typ:Array<string>
Ein Array von Zeichenfolgen, die den Typ dieser Adresskomponente angeben. Eine Liste der gültigen Typen finden Sie hier.

Attribution-Klasse

google.maps.places.Attribution Klasse

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

provider
Typ:string optional
Hinweistext, der für dieses Places-Ergebnis angezeigt werden soll
providerURI
Typ:string optional

FetchFieldsRequest

google.maps.places.FetchFieldsRequest-Schnittstelle

Optionen zum Abrufen von „Place“-Feldern.

fields
Typ:Array<string>
Liste der abzurufenden Felder.

OpeningHours-Klasse

google.maps.places.OpeningHours Klasse

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

periods
Öffnungszeiten, die die einzelnen Wochentage abdecken, beginnend am Sonntag, in chronologischer Reihenfolge. Tage, an denen der Ort nicht geöffnet ist, werden nicht berücksichtigt.
weekdayDescriptions
Typ:Array<string>
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 am Montag, in anderen am Sonntag.

OpeningHoursPeriod-Klasse

google.maps.places.OpeningHoursPeriod Klasse

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

close
Typ:OpeningHoursPoint optional
Die Schließzeit des Orts.
open
Die Öffnungszeit für den Ort.

OpeningHoursPoint-Klasse

google.maps.places.OpeningHoursPoint Klasse

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

day
Typ:number
Der Wochentag als Zahl im Bereich [0, 6], beginnend mit Sonntag. Beispiel: 2 bedeutet Dienstag.
hour
Typ:number
Die Stunde von OpeningHoursPoint.time als Zahl im Bereich [0, 23]. Dies wird in der Zeitzone des Orts angegeben.
minute
Typ:number
Die Minute von OpeningHoursPoint.time als Zahl im Bereich [0, 59]. Dies wird in der Zeitzone des Orts angegeben.

Fotoklasse

google.maps.places.Photo Klasse

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

authorAttributions
Hinweistext, der für dieses Foto angezeigt werden soll.
heightPx
Typ:number
Die Höhe des Fotos in Pixeln.
widthPx
Typ:number
Die Breite des Fotos in Pixeln.
getURI
getURI([options])
Parameter:
Rückgabewert:  string
Gibt die Bild-URL für die angegebenen Optionen zurück

AuthorAttribution-Klasse

google.maps.places.AuthorAttribution Klasse

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

displayName
Typ:string
Name des Autors für dieses Ergebnis.
photoURI
Typ:string optional
Foto-URI des Autors für dieses Ergebnis. Diese Option ist möglicherweise nicht immer verfügbar.
uri
Typ:string optional
Profil-URI des Autors für dieses Ergebnis.

PlusCode-Klasse

google.maps.places.PlusCode Klasse

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

compoundCode
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 Zürich, Schweiz“.
globalCode
Typ:string optional
Ein Plus Code mit einem 1/8.000. eines Grades mal 1/8000. eines Gradbereichs. Beispiel: „8FVC9G8F+5W“.

Review-Klasse

google.maps.places.Review Klasse

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

authorAttribution
Typ:AuthorAttribution optional
Die prüfende Person.
publishTime
Typ:Date optional
rating
Typ:number optional
Die Bewertung der Rezension. Eine Zahl zwischen 1,0 und 5,0 (jeweils einschließlich).
relativePublishTimeDescription
Typ:string optional
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: "Vor einem Monat".
text
Typ:string optional
Der Text einer Rezension.
textLanguageCode
Typ:string optional
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.

PriceLevel-Konstanten

google.maps.places.PriceLevel-Konstanten

Aufzählung der Preisebene für Place-Objekte.

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

SearchByTextRequest.

google.maps.places.SearchByTextRequest-Schnittstelle

Anfrageschnittstelle für Place.searchByText

fields
Typ:Array<string>
Felder, die in die Antwort aufgenommen werden und in Rechnung gestellt werden. Wenn ['*'] ü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").
includedType optional
Typ:string optional
Der angeforderte Ortstyp. Eine vollständige Liste der unterstützten Typen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. Es wird nur ein eingeschlossener Typ unterstützt. SearchByTextRequest.useStrictTypeFiltering ansehen
isOpenNow optional
Typ:boolean optional
Standardwert: false
Wird verwendet, um die Suche auf Orte einzuschränken, die derzeit geöffnet sind.
language optional
Typ:string optional
Ortsdetails werden in der bevorzugten Sprache angezeigt, sofern verfügbar. Wird standardmäßig auf die Spracheinstellung des Browsers festgelegt. Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
Die Region, in der gesucht werden soll. Dieser Standort dient als Verzerrung, das heißt, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können. Kann nicht zusammen mit „locationRestriction“ festgelegt werden.
locationRestriction optional
Die Region, in der gesucht werden soll. Dieser Standort dient als Einschränkung, was bedeutet, dass keine Ergebnisse außerhalb des angegebenen Standorts zurückgegeben werden. Kann nicht zusammen mit locationBias festgelegt werden.
maxResultCount optional
Typ:number optional
Maximale Anzahl der zurückzugebenden Ergebnisse; Der Wert muss zwischen 1 und 20 liegen.
minRating optional
Typ:number optional
Filtern Sie Ergebnisse heraus, deren durchschnittliche Nutzerbewertung grundsätzlich unter diesem Grenzwert liegt. Ein gültiger Wert muss eine Gleitkommazahl zwischen 0 und 5 (einschließlich) bei einer Kadenz von 0,5 sein, d. h. [0, 0,5, 1,0, ... , 5,0] (jeweils einschließlich). Die Eingabe wird auf den nächsten Wert auf 0,5(Obergrenze) aufgerundet. Beispielsweise werden bei einer Bewertung von 0,6 alle Ergebnisse mit einer Bewertung unter 1,0 ausgeschlossen.
priceLevels optional
Typ:Array<PriceLevel> optional
Wird verwendet, um die Suche auf Orte zu beschränken, die mit bestimmten Preisstufen gekennzeichnet sind. Es können beliebige Kombinationen von Preisstufen ausgewählt werden. Die Standardeinstellung ist alle Preisstufen.
query optional
Typ:string optional
BetarankBy optional
rankPreference optional
Standardwert: SearchByTextRankPreference.DISTANCE
Wie die Ergebnisse in der Antwort sortiert werden.
region optional
Typ:string optional
Der Unicode-Ländercode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname (falls verfügbar). Der Parameter kann sich gemäß anwendbarem Recht auf Ergebnisse auswirken. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Dreistellige Regionscodes werden derzeit nicht unterstützt.
textQuery optional
Typ:string optional
Erforderlich. Die Textabfrage für die Textsuche.
useStrictTypeFiltering optional
Typ:boolean optional
Standardwert: false
Wird verwendet, um die strikte Filterung des Typs "SearchByTextRequest.includedType" festzulegen. Wenn die Richtlinie auf „true“ gesetzt ist, werden nur Ergebnisse desselben Typs zurückgegeben.

SearchByTextRankPreference-Konstanten

google.maps.places.SearchByTextRankPreference-Konstanten

RankPräferenz-Enum für SearchByTextRequest.

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

DISTANCE Ergebnisse werden nach Entfernung sortiert.
RELEVANCE Die Ergebnisse werden nach Relevanz sortiert.