REST Resource: places

Ressource: Ort

Alle Informationen, die einen Ort repräsentieren.

JSON-Darstellung
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Felder
name

string

Der Ressourcenname dieses Orts im Format places/{placeId}. Kann verwendet werden, um den Ort zu suchen.

id

string

Die eindeutige Kennung eines Orts.

displayName

object (LocalizedText)

Der lokalisierte Name des Orts, der sich als kurze menschenlesbare Beschreibung eignet. Beispiele: „Google Sydney“, „Starbucks“, „Pyrmont“ usw.

types[]

string

Eine Reihe von Typ-Tags für dieses Ergebnis. Beispiel: „political“ und „locality“. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types.

primaryType

string

Der primäre Typ des angegebenen Ergebnisses. Dieser Typ muss einer der von der Places API unterstützten Typen sein. Beispiele: „Restaurant“, „Café“, „Flughafen“ usw. Ein Ort kann nur einen primären Typ haben. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. Der primäre Typ fehlt möglicherweise, wenn der primäre Typ des Orts nicht unterstützt wird. Wenn ein primärer Typ vorhanden ist, ist er immer einer der Typen im Feld types.

primaryTypeDisplayName

object (LocalizedText)

Der angezeigte Name des primären Typs, sofern zutreffend in der Sprache der Anfrage lokalisiert. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. Der primäre Typ fehlt möglicherweise, wenn der primäre Typ des Orts nicht unterstützt wird.

nationalPhoneNumber

string

Eine für Menschen lesbare Telefonnummer für den Ort im nationalen Format.

internationalPhoneNumber

string

Eine lesbare Telefonnummer für den Ort im internationalen Format.

formattedAddress

string

Eine vollständige, für Menschen lesbare Adresse für diesen Ort.

shortFormattedAddress

string

Eine kurze, für Menschen lesbare Adresse für diesen Ort.

postalAddress

object (PostalAddress)

Die Adresse im Format einer Postadresse.

addressComponents[]

object (AddressComponent)

Wiederholte Komponenten für jede Lokalitätsebene. Hinweise zum Array „addressComponents[]“: - Das Array der Adresskomponenten kann mehr Komponenten als nur „formattedAddress“ enthalten. – Das Array enthält nicht unbedingt alle politischen Einheiten einer Adresse. Ausgenommen hiervon sind die in „formattedAddress“ enthaltenen. Wenn Sie alle politischen Einheiten abrufen möchten, die zu einer bestimmten Adresse gehören, müssen Sie die umgekehrte Geocodierung verwenden. Dabei wird der Breiten-/Längengrad der Adresse als Parameter an die Anfrage übergeben. – Es kann nicht garantiert werden, dass das Antwortformat zwischen mehreren Anfragen gleich bleibt. Insbesondere die Anzahl der „addressComponents“ variiert je nach angeforderter Adresse und kann sich im Laufe der Zeit für dieselbe Adresse ändern. Die Position einer Komponente im Array ändert sich unter Umständen. Auch der Typ der Komponente kann sich ändern. In einer späteren Anfrage fehlt evtl. auch eine bestimmte Komponente.

plusCode

object (PlusCode)

Plus Code für den Breiten-/Längengrad des Orts.

location

object (LatLng)

Die Position dieses Orts.

viewport

object (Viewport)

Ein Darstellungsbereich, der sich für die Anzeige des Orts auf einer Karte durchschnittlicher Größe eignet. Dieser Ausschnitt sollte nicht als physische Grenze oder Einzugsgebiet des Unternehmens verwendet werden.

rating

number

Eine Bewertung zwischen 1,0 und 5,0, die auf Nutzerrezensionen dieses Orts basiert.

googleMapsUri

string

Eine URL mit weiteren Informationen zu diesem Ort.

websiteUri

string

Die offizielle Website des Ortes, z.B. die Homepage eines Unternehmens. Bei Orten, die Teil einer Kette sind (z.B. ein IKEA-Geschäft), ist das in der Regel die Website für das einzelne Geschäft und nicht für die gesamte Kette.

reviews[]

object (Review)

Liste der Rezensionen zu diesem Ort, sortiert nach Relevanz. Es können maximal fünf Rezensionen zurückgegeben werden.

regularOpeningHours

object (OpeningHours)

Die regulären Öffnungszeiten. Wenn ein Ort durchgängig geöffnet ist (24 Stunden), wird das Feld close nicht festgelegt. Clients können sich darauf verlassen, dass „Immer geöffnet“ (24 Stunden) als open-Zeitraum mit day mit dem Wert 0, hour mit dem Wert 0 und minute mit dem Wert 0 dargestellt wird.

timeZone

object (TimeZone)

Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“.

photos[]

object (Photo)

Informationen (einschließlich Referenzen) zu Fotos dieses Orts. Es können maximal 10 Fotos zurückgegeben werden.

adrFormatAddress

string

Die Adresse des Orts im ADR-Mikroformat: http://microformats.org/wiki/adr.

businessStatus

enum (BusinessStatus)

Der Unternehmensstatus für den Ort.

priceLevel

enum (PriceLevel)

Preisniveau des Orts.

attributions[]

object (Attribution)

Eine Reihe von Datenanbietern, die mit diesem Ergebnis angezeigt werden müssen.

iconMaskBaseUri

string

Eine gekürzte URL zu einer Symbolmaske. Nutzer können auf verschiedene Symboltypen zugreifen, indem sie ein Typsuffix an das Ende anhängen, z. B. „.svg“ oder „.png“.

iconBackgroundColor

string

Hintergrundfarbe für „icon_mask“ im Hexadezimalformat, z.B. #909CE1.

currentOpeningHours

object (OpeningHours)

Die Öffnungszeiten für die nächsten sieben Tage (einschließlich heute). Der Zeitraum beginnt am Tag der Anfrage um Mitternacht und endet sechs Tage später um 23:59 Uhr. Dieses Feld enthält das Unterfeld „specialDays“ aller Öffnungszeiten, die für Datumsangaben mit besonderen Öffnungszeiten festgelegt sind.

currentSecondaryOpeningHours[]

object (OpeningHours)

Enthält ein Array von Einträgen für die nächsten sieben Tage, einschließlich Informationen zu den sekundären Öffnungszeiten eines Unternehmens. Die sekundären Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-through-Schalters oder die Lieferzeiten als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt. Es basiert auf einer vordefinierten Liste von Öffnungszeiten-Typen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) und den Typen des Orts. Dieses Feld enthält das Unterfeld „specialDays“ aller Öffnungszeiten, die für Datumsangaben mit besonderen Öffnungszeiten festgelegt sind.

regularSecondaryOpeningHours[]

object (OpeningHours)

Enthält ein Array von Einträgen mit Informationen zu den regulären sekundären Öffnungszeiten eines Unternehmens. Die sekundären Öffnungszeiten unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise die Öffnungszeiten des Drive-through-Schalters oder die Lieferzeiten als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld „type“ ausgefüllt. Es basiert auf einer vordefinierten Liste von Öffnungszeiten-Typen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) und den Typen des Orts.

editorialSummary

object (LocalizedText)

Enthält eine Zusammenfassung des Orts. Eine Zusammenfassung besteht aus einer textlichen Übersicht und enthält gegebenenfalls auch den Sprachcode. Der Zusammenfassungstext muss unverändert präsentiert werden und darf nicht geändert oder angepasst werden.

paymentOptions

object (PaymentOptions)

Zahlungsoptionen, die an diesem Ort akzeptiert werden. Wenn keine Daten für eine Zahlungsoption verfügbar sind, wird das Feld für die Zahlungsoption nicht festgelegt.

parkingOptions

object (ParkingOptions)

Parkmöglichkeiten, die vom Ort angeboten werden.

subDestinations[]

object (SubDestination)

Eine Liste von Unterzielen, die mit dem Ort in Verbindung stehen.

fuelOptions

object (FuelOptions)

Die neuesten Informationen zu den Kraftstoffoptionen an einer Tankstelle. Diese Informationen werden regelmäßig aktualisiert.

evChargeOptions

object (EVChargeOptions)

Informationen zu Ladeoptionen für Elektrofahrzeuge.

generativeSummary

object (GenerativeSummary)

KI‑generierte Zusammenfassung des Orts.

containingPlaces[]

object (ContainingPlace)

Liste der Orte, an denen sich der aktuelle Ort befindet.

addressDescriptor

object (AddressDescriptor)

Der Adressdeskriptor des Orts. Adressdeskriptoren enthalten zusätzliche Informationen, mit denen ein Ort anhand von Sehenswürdigkeiten und Gebieten beschrieben wird. Informationen zur regionalen Abdeckung von Adressdeskriptoren finden Sie unter https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.

priceRange

object (PriceRange)

Die Preisspanne, die mit einem Ort verknüpft ist.

reviewSummary

object (ReviewSummary)

KI‑generierte Zusammenfassung des Orts anhand von Nutzerrezensionen.

evChargeAmenitySummary

object (EvChargeAmenitySummary)

Die Zusammenfassung der Einrichtungen in der Nähe der Ladestation für Elektrofahrzeuge.

neighborhoodSummary

object (NeighborhoodSummary)

Eine Zusammenfassung der Sehenswürdigkeiten in der Nähe des Ortes.

utcOffsetMinutes

integer

Anzahl der Minuten, um die die Zeitzone dieses Orts derzeit von UTC abweicht. Die Zeit wird in Minuten angegeben, um Zeitzonen zu unterstützen, die um Bruchteile einer Stunde verschoben sind, z.B. X Stunden und 15 Minuten.

userRatingCount

integer

Die Gesamtzahl der Rezensionen (mit oder ohne Text) für diesen Ort.

takeout

boolean

Gibt an, ob das Unternehmen Essen zum Mitnehmen anbietet.

delivery

boolean

Gibt an, ob das Unternehmen einen Lieferservice anbietet.

dineIn

boolean

Gibt an, ob das Unternehmen Sitzplätze im Innen- oder Außenbereich anbietet.

curbsidePickup

boolean

Gibt an, ob das Unternehmen die Abholung vor dem Geschäft unterstützt.

reservable

boolean

Gibt an, ob für den Ort Reservierungen möglich sind.

servesBreakfast

boolean

Gibt an, ob an diesem Ort Frühstück serviert wird.

servesLunch

boolean

Gibt an, ob an diesem Ort Mittagessen serviert wird.

servesDinner

boolean

Gibt an, ob an diesem Ort Abendessen serviert wird.

servesBeer

boolean

Gibt an, ob an diesem Ort Bier ausgeschenkt wird.

servesWine

boolean

Gibt an, ob an diesem Ort Wein ausgeschenkt wird.

servesBrunch

boolean

Gibt an, ob an diesem Ort Brunch angeboten wird.

servesVegetarianFood

boolean

Gibt an, ob an diesem Ort vegetarische Speisen serviert werden.

outdoorSeating

boolean

Es gibt Sitzgelegenheiten im Freien.

liveMusic

boolean

Hier gibt es Livemusik.

menuForChildren

boolean

Es gibt eine Speisekarte für Kinder.

servesCocktails

boolean

Hier werden Cocktails serviert.

servesDessert

boolean

Hier wird Dessert serviert.

servesCoffee

boolean

Hier wird Kaffee serviert.

goodForChildren

boolean

Der Ort ist gut für Kinder geeignet.

allowsDogs

boolean

Hunde sind erlaubt.

restroom

boolean

WC vorhanden

goodForGroups

boolean

Die Unterkunft bietet Platz für Gruppen.

goodForWatchingSports

boolean

Der Ort eignet sich für Sportübertragungen.

accessibilityOptions

object (AccessibilityOptions)

Informationen zu den Optionen für Barrierefreiheit, die an einem Ort angeboten werden.

pureServiceAreaBusiness

boolean

Gibt an, ob es sich bei dem Ort um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt. Ein reines Unternehmen ohne festen Standort in einem Einzugsgebiet ist ein Unternehmen, das Kunden vor Ort besucht oder einen Lieferservice hat, aber an seiner Geschäftsadresse keine Kunden empfängt. Dazu gehören z. B. Reinigungsfirmen oder Klempner. Diese Unternehmen haben möglicherweise keine physische Adresse oder keinen Standort auf Google Maps.

LocalizedText

Lokalisierte Variante eines Texts in einer bestimmten Sprache.

JSON-Darstellung
{
  "text": string,
  "languageCode": string
}
Felder
text

string

Lokalisierter String in der Sprache, die languageCode entspricht.

languageCode

string

Der BCP-47-Sprachcode des Texts, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

PostalAddress

Stellt eine Postadresse dar, z. B. für Postzustellungs- oder Zahlungsadressen. Mit einer Postadresse kann ein Postdienst Artikel an eine Einrichtung, ein Postfach oder eine andere Adresse liefern. Eine Postanschrift ist kein Modell eines geografischen Standorts wie Straßen, Städte oder Berge.

Normalerweise wird eine Adresse je nach Prozesstyp durch eine Nutzereingabe oder den Import vorhandener Daten erstellt.

Hinweise zur Eingabe oder Bearbeitung von Adressen:

  • Verwenden Sie ein internationalisierungsfähiges Address Widget wie https://github.com/google/libaddressinput.
  • Nutzer sollten nur UI-Elemente für die Eingabe oder Bearbeitung von Feldern sehen, die in ihrem Land verwendet werden.

Weitere Informationen zur Verwendung dieses Schemas finden Sie unter https://support.google.com/business/answer/6397478.

JSON-Darstellung
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Felder
revision

integer

Das überarbeitete Schema von PostalAddress. Die Einstellung muss 0 lauten, was der aktuellen Überarbeitung entspricht.

Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein.

regionCode

string

Erforderlich. CLDR-Regionscode des Landes bzw. der Region der Adresse. Er wird nie abgeleitet. Der Nutzer muss sicherstellen, dass der Wert richtig ist. Ausführliche Informationen finden Sie unter https://cldr.unicode.org/ und https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz.

languageCode

string

Optional. BCP-47-Sprachencode des Inhalts dieser Adresse, falls bekannt. Dies ist oft die Sprache der UI des Eingabeformulars oder die Sprache, die mit einer der verwendeten Sprachen des Landes bzw. der Region mit der Adresse oder der entsprechenden Transliteration übereinstimmt. In bestimmten Ländern hat dies Auswirkungen auf die Formatierung. Es ist jedoch nicht entscheidend für die Richtigkeit der Daten und hat niemals Auswirkungen auf Validierungen oder andere nicht formatierungsbezogene Vorgänge.

Wenn dieser Wert nicht bekannt ist, sollte er weggelassen werden. Das ist besser, als einen möglicherweise falschen Wert anzugeben.

Beispiele: "zh-Hant", "ja", "ja-Latn", "en"

postalCode

string

Optional. Postleitzahl der Adresse. Postleitzahlen werden nicht in allen Ländern verwendet oder benötigt. Dort, wo sie verwendet werden, können sie weitere Validierungsvorgänge für andere Adressteile nach sich ziehen, z. B. die Validierung von Bundesstaat oder Postleitzahl in den USA.

sortingCode

string

Optional. Zusätzlicher länderspezifischer Sortiercode. Dieser wird nur für wenige Regionen genutzt. Der Wert ist entweder ein String wie „CEDEX“, optional gefolgt von einer Zahl (z. B. „CEDEX 7“), oder nur eine Zahl, die den „sector code“ (Jamaika), „delivery area indicator“ (Malawi) oder „post office indicator“ (Côte d'Ivoire) darstellt.

administrativeArea

string

Optional. Höchste administrative Untergliederung, die für Postadressen eines Landes oder einer Region verwendet wird. Dies kann beispielsweise ein Bundesland, eine Provinz, eine Oblast oder eine Präfektur sein. In Spanien ist das beispielsweise die Provinz und nicht das autonome Gebiet, also z. B. „Barcelona“ und nicht „Katalonien“. In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. In der Schweiz etwa sollte dieses Feld leer gelassen werden.

locality

string

Optional. Bezieht sich in der Regel auf die Stadt-/Ortsangabe der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. Lassen Sie in Regionen der Welt, in denen Postorte nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, locality leer und verwenden Sie stattdessen addressLines.

sublocality

string

Optional. Unterlokalität der Adresse. Dies kann beispielsweise ein Stadtteil, ein Bezirk oder ein Stadtviertel sein.

addressLines[]

string

Unstrukturierte Adresszeilen, mit denen die unteren Ebenen einer Adresse beschrieben werden.

Da die Werte in addressLines keine Typinformationen beinhalten und manchmal mehrere Werte in einem einzigen Feld enthalten sind, z. B. „Austin, TX“, muss die Zeilenreihenfolge deutlich erkennbar sein. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen. An Orten, an denen es keine einheitliche Reihenfolge gibt, z. B. in Japan, wird address_language verwendet, um dies klar zu machen (z. B. „ja“ für die Reihenfolge groß zu klein und „ja-Latn“ oder „en“ für die Reihenfolge klein zu groß). Auf diese Weise kann die spezifischste Zeile einer Adresse sprachabhängig ausgewählt werden.

Die Mindestangabe für eine zulässige strukturierte Darstellung einer Adresse besteht aus einem regionCode und allen verbleibenden Informationen in addressLines. Eine solche Adresse kann weitgehend angenähert ohne Geocodierung formatiert werden. Es wäre jedoch erst dann eine semantische Argumentation zu einer der Adresskomponenten möglich, wenn diese zumindest teilweise aufgelöst wird.

Es empfiehlt sich, für vollständig unstrukturierte Adressen eine Adresse mit einem regionCode und addressLines zu erstellen und danach eine Geocodierung dafür durchzuführen. So muss nicht geraten werden, welche Teile der Adresse Orte oder administrative Gebiete darstellen.

recipients[]

string

Optional. Der Empfänger an der Adresse. Dieses Feld kann in bestimmten Fällen mehrere Zeilen lange Informationen enthalten. Beispielsweise kann es Informationen der Art "wohnhaft bei" enthalten.

organization

string

Optional. Der Name der Organisation an der Adresse.

AddressComponent

Die strukturierten Komponenten, aus denen die formatierte Adresse besteht, sofern diese Informationen verfügbar sind.

JSON-Darstellung
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Felder
longText

string

Die Volltextbeschreibung oder der Name der Adresskomponente. Beispielsweise könnte eine Adresskomponente für das Land Australien den long_name „Australia“ haben.

shortText

string

Ein abgekürzter Textname für die Adresskomponente, falls vorhanden. Beispielsweise könnte eine Adresskomponente für das Land Australien den short_name „AU“ haben.

types[]

string

Ein Array, das den oder die Typen der Adresskomponente angibt.

languageCode

string

Die Sprache, die zum Formatieren dieser Komponenten verwendet wird, in CLDR-Notation.

PlusCode

Der Plus Code (http://plus.codes) ist ein Standortverweis mit zwei Formaten: einem globalen Code, der ein Rechteck von 14 m × 14 m (1/8.000stel eines Grades) oder kleiner definiert, und einem zusammengesetzten Code, bei dem das Präfix durch einen Referenzstandort ersetzt wird.

JSON-Darstellung
{
  "globalCode": string,
  "compoundCode": string
}
Felder
globalCode

string

Der globale (vollständige) Code des Orts, z. B. „9FWM33GV+HQ“, der einen Bereich von 1/8.000 × 1/8.000 Grad (~14 × 14 Meter) darstellt.

compoundCode

string

Der zusammengesetzte Code des Orts, z. B. „33GV+HQ, Ramberg, Norwegen“, der das Suffix des globalen Codes enthält und das Präfix durch einen formatierten Namen einer Referenzentität ersetzt.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Darstellungsbereich

Ein Darstellungsbereich für Breiten- und Längengrad, der als zwei diagonal gegenüberliegende Punkte low und high dargestellt wird. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er umfasst seine Grenze. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen (einschließlich), die Längengradgrenzen zwischen -180 und 180 Grad (einschließlich). Dazu gehören:

  • Wenn low = high ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.

  • Wenn low.longitude > high.longitude, wird der Längengradbereich umgekehrt (der Darstellungsbereich überschreitet die 180-Grad-Längengradlinie).

  • Wenn low.longitude = -180 Grad und high.longitude = 180 Grad ist, umfasst der Darstellungsbereich alle Längengrade.

  • Wenn low.longitude = 180 Grad und high.longitude = -180 Grad ist, ist der Längengradbereich leer.

  • Wenn low.latitude > high.latitude, ist der Breitengradbereich leer.

Sowohl low als auch high müssen ausgefüllt sein und das dargestellte Rechteck darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Viewport führt zu einem Fehler.

Beispiel: Dieser Viewport umfasst New York City vollständig:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON-Darstellung
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Felder
low

object (LatLng)

Erforderlich. Der niedrigste Punkt des Darstellungsbereichs.

high

object (LatLng)

Erforderlich. Der höchste Punkt des Darstellungsbereichs.

Überprüfen

Informationen zu einer Rezension eines Orts.

JSON-Darstellung
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Felder
name

string

Eine Referenz für diese Rezension, mit der sie noch einmal aufgerufen werden kann (auch API-Ressourcenname genannt: places/{placeId}/reviews/{review}).

relativePublishTimeDescription

string

Ein String mit der formatierten letzten Zeit, in der die Rezensionszeit relativ zur aktuellen Zeit in einer für die Sprache und das Land geeigneten Form angegeben wird.

text

object (LocalizedText)

Der lokalisierte Text der Rezension.

originalText

object (LocalizedText)

Der Rezensionstext in der Originalsprache.

rating

number

Eine Zahl zwischen 1,0 und 5,0, auch als Anzahl der Sterne bezeichnet.

authorAttribution

object (AuthorAttribution)

Der Autor dieser Rezension.

publishTime

string (Timestamp format)

Zeitstempel für die Rezension.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

flagContentUri

string

Ein Link, über den Nutzer ein Problem mit der Rezension melden können.

googleMapsUri

string

Ein Link, über den die Rezension in Google Maps aufgerufen werden kann.

AuthorAttribution

Informationen zum Autor der UGC-Daten. Verwendet in Photo und Review.

JSON-Darstellung
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Felder
displayName

string

Der Name des Autors von Photo oder Review.

uri

string

URI des Autors von Photo oder Review.

photoUri

string

Profilbild-URI des Autors von Photo oder Review.

OpeningHours

Informationen zu den Öffnungszeiten des Orts.

JSON-Darstellung
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Felder
periods[]

object (Period)

Die Zeiträume, in denen dieser Ort in der Woche geöffnet ist. Die Zeiträume sind in chronologischer Reihenfolge in der Zeitzone des Ortes angegeben. Ein leerer (aber nicht fehlender) Wert gibt einen Ort an, der nie geöffnet ist, z.B. weil er vorübergehend wegen Renovierungsarbeiten geschlossen ist.

Der Starttag von periods ist NICHT festgelegt und sollte nicht als Sonntag angenommen werden. Der Starttag wird von der API anhand verschiedener Faktoren bestimmt. Bei einem Unternehmen, das rund um die Uhr geöffnet ist, kann der erste Zeitraum beispielsweise am Tag der Anfrage beginnen. Für andere Unternehmen ist es möglicherweise der erste Tag der Woche, an dem sie geöffnet sind.

HINWEIS: Die Reihenfolge des periods-Arrays ist unabhängig von der Reihenfolge des weekdayDescriptions-Arrays. Gehen Sie nicht davon aus, dass sie am selben Tag beginnen.

weekdayDescriptions[]

string

Lokalisierte Strings, die die Öffnungszeiten dieses Orts beschreiben, ein String für jeden Wochentag.

HINWEIS: Die Reihenfolge der Tage und der Wochenbeginn werden durch das Gebietsschema (Sprache und Region) bestimmt. Die Reihenfolge des periods-Arrays ist unabhängig von der Reihenfolge des weekdayDescriptions-Arrays. Gehen Sie nicht davon aus, dass sie am selben Tag beginnen.

Ist leer, wenn die Öffnungszeiten unbekannt sind oder nicht in lokalisierten Text konvertiert werden konnten. Beispiel: „So: 18:00–06:00“

secondaryHoursType

enum (SecondaryHoursType)

Ein Typstring zur Identifizierung des Typs der sekundären Öffnungszeiten.

specialDays[]

object (SpecialDay)

Strukturierte Informationen für besondere Tage, die in den Zeitraum fallen, für den die zurückgegebenen Öffnungszeiten gelten. Besondere Tage sind Tage, die sich auf die Öffnungszeiten eines Orts auswirken können, z.B. Weihnachten. Legen Sie „currentOpeningHours“ und „currentSecondaryOpeningHours“ fest, wenn es abweichende Öffnungszeiten gibt.

nextOpenTime

string (Timestamp format)

Das nächste Mal, wenn der aktuelle Zeitraum für die Öffnungszeiten beginnt, ist in bis zu 7 Tagen. Dieses Feld wird nur ausgefüllt, wenn der Zeitraum der Öffnungszeiten zum Zeitpunkt der Bearbeitung der Anfrage nicht aktiv ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

nextCloseTime

string (Timestamp format)

Das nächste Mal, wenn der aktuelle Zeitraum für die Öffnungszeiten endet, ist in bis zu 7 Tagen. Dieses Feld wird nur ausgefüllt, wenn der Zeitraum der Öffnungszeiten zum Zeitpunkt der Bearbeitung der Anfrage aktiv ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

openNow

boolean

Gibt an, ob der Zeitraum der Öffnungszeiten derzeit aktiv ist. Bei regulären und aktuellen Öffnungszeiten gibt dieses Feld an, ob der Ort geöffnet ist. Bei sekundären Öffnungszeiten und aktuellen sekundären Öffnungszeiten gibt dieses Feld an, ob die sekundären Öffnungszeiten dieses Orts aktiv sind.

Zeitraum

Ein Zeitraum, in dem der Ort den Status „openNow“ hat.

JSON-Darstellung
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Felder
open

object (Point)

Die Uhrzeit, zu der der Ort geöffnet wird.

close

object (Point)

Der Zeitpunkt, zu dem der Ort geschlossen wird.

Punkt

Punkte, an denen sich der Status ändert.

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Felder
date

object (Date)

Datum in der lokalen Zeitzone des Orts.

truncated

boolean

Gibt an, ob dieser Endpunkt gekürzt wurde. Eine Kürzung erfolgt, wenn die tatsächlichen Öffnungszeiten außerhalb des Zeitraums liegen, für den wir Öffnungszeiten zurückgeben möchten. In diesem Fall werden die Öffnungszeiten auf diese Grenzen zurückgesetzt. So werden maximal 24 * 7 Stunden ab Mitternacht des Tages der Anfrage zurückgegeben.

day

integer

Ein Wochentag als Ganzzahl im Bereich von 0 bis 6. 0 ist Sonntag, 1 ist Montag usw.

hour

integer

Die Stunde im 24‑Stunden-Format. Liegt im Bereich von 0 bis 23.

minute

integer

Die Minute. Liegt im Bereich von 0 bis 59.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit einem Monat und einem Tag von 0.
  • Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.

Ähnliche Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.

month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.

SecondaryHoursType

Ein Typ, der zur Identifizierung des Typs der sekundären Öffnungszeiten verwendet wird.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED Standardwert, wenn der sekundäre Stundentyp nicht angegeben ist.
DRIVE_THROUGH Die Drive-through-Öffnungszeiten für Banken, Restaurants oder Apotheken.
HAPPY_HOUR Die Happy Hour.
DELIVERY Die Lieferstunde.
TAKEOUT Die Abholzeit.
KITCHEN Die Küchenstunde.
BREAKFAST Die Frühstückszeit.
LUNCH Die Mittagspause.
DINNER Die Abendessenszeit.
BRUNCH Die Brunch-Stunde.
PICKUP Die Abholzeit.
ACCESS Die Zugriffszeiten für Lagerorte.
SENIOR_HOURS Die speziellen Öffnungszeiten für Senioren.
ONLINE_SERVICE_HOURS Die Online-Geschäftszeiten.

SpecialDay

Strukturierte Informationen für besondere Tage, die in den Zeitraum fallen, für den die zurückgegebenen Öffnungszeiten gelten. Besondere Tage sind Tage, die sich auf die Öffnungszeiten eines Orts auswirken können, z.B. Weihnachten.

JSON-Darstellung
{
  "date": {
    object (Date)
  }
}
Felder
date

object (Date)

Das Datum dieses besonderen Tages.

TimeZone

Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.

JSON-Darstellung
{
  "id": string,
  "version": string
}
Felder
id

string

Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“.

version

string

Optional. Versionsnummer der IANA-Zeitzonendatenbank. Beispiel: „2019a“.

Foto

Informationen zu einem Foto eines Orts.

JSON-Darstellung
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Felder
name

string

Kennung. Eine Referenz, die dieses Ortsfoto repräsentiert und mit der dieses Ortsfoto noch einmal aufgerufen werden kann (auch API-Ressourcenname genannt: places/{placeId}/photos/{photo}).

widthPx

integer

Die maximal verfügbare Breite in Pixeln.

heightPx

integer

Die maximal verfügbare Höhe in Pixeln.

authorAttributions[]

object (AuthorAttribution)

Die Autoren dieses Fotos.

flagContentUri

string

Ein Link, über den Nutzer ein Problem mit dem Foto melden können.

googleMapsUri

string

Ein Link zum Anzeigen des Fotos auf Google Maps.

BusinessStatus

Der Unternehmensstatus für den Ort.

Enums
BUSINESS_STATUS_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
OPERATIONAL Das Unternehmen ist in Betrieb, aber nicht unbedingt jetzt geöffnet.
CLOSED_TEMPORARILY Das Unternehmen ist vorübergehend geschlossen.
CLOSED_PERMANENTLY Das Geschäft ist dauerhaft geschlossen.

PriceLevel

Preisniveau des Orts.

Enums
PRICE_LEVEL_UNSPECIFIED Die Preisstufe des Orts ist nicht angegeben oder unbekannt.
PRICE_LEVEL_FREE Der Ort bietet kostenlose Dienstleistungen an.
PRICE_LEVEL_INEXPENSIVE Hier werden günstige Dienstleistungen angeboten.
PRICE_LEVEL_MODERATE Hier werden Dienstleistungen zu einem angemessenen Preis angeboten.
PRICE_LEVEL_EXPENSIVE Hier werden teure Dienstleistungen angeboten.
PRICE_LEVEL_VERY_EXPENSIVE Der Ort bietet sehr teure Dienstleistungen an.

Attribution

Informationen zu den Datenanbietern dieses Orts.

JSON-Darstellung
{
  "provider": string,
  "providerUri": string
}
Felder
provider

string

Name des Datenanbieters des Orts.

providerUri

string

URI des Datenanbieters des Orts.

PaymentOptions

Zahlungsoptionen, die an diesem Ort akzeptiert werden.

JSON-Darstellung
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Felder
acceptsCreditCards

boolean

Kreditkarten werden als Zahlungsmittel akzeptiert.

acceptsDebitCards

boolean

An diesem Ort werden Debitkarten als Zahlungsmittel akzeptiert.

acceptsCashOnly

boolean

An diesem Ort wird nur Barzahlung akzeptiert. An Orten mit diesem Attribut werden möglicherweise auch andere Zahlungsmethoden akzeptiert.

acceptsNfc

boolean

Hier werden NFC-Zahlungen akzeptiert.

ParkingOptions

Informationen zu Parkmöglichkeiten für den Ort. Ein Parkplatz kann mehrere Optionen gleichzeitig unterstützen.

JSON-Darstellung
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Felder
freeParkingLot

boolean

Parkplätze stehen kostenlos zur Verfügung.

paidParkingLot

boolean

Gebührenpflichtige Parkplätze sind vorhanden.

freeStreetParking

boolean

Kostenlose Parkplätze an der Straße sind verfügbar.

paidStreetParking

boolean

Gebührenpflichtige Parkplätze an der Straße sind vorhanden.

valetParking

boolean

Ein Einparkservice ist verfügbar.

freeGarageParking

boolean

Kostenlose Garagenparkplätze sind vorhanden.

paidGarageParking

boolean

Gebührenpflichtige Garagenparkplätze sind vorhanden.

SubDestination

Unterziele sind bestimmte Orte, die mit einem Hauptort verknüpft sind. Sie bieten Nutzern, die an einem großen oder komplexen Ort wie einem Flughafen, Nationalpark, einer Universität oder einem Stadion suchen, genauere Ziele. Unterziele an einem Flughafen können beispielsweise zugehörige Terminals und Parkplätze sein. Für untergeordnete Ziele werden die Orts-ID und der Ressourcenname des Orts zurückgegeben. Diese können in nachfolgenden Place Details (New)-Anfragen verwendet werden, um umfassendere Details abzurufen, darunter den Anzeigenamen und den Standort des untergeordneten Ziels.

JSON-Darstellung
{
  "name": string,
  "id": string
}
Felder
name

string

Der Ressourcenname des untergeordneten Ziels.

id

string

Die Orts-ID des untergeordneten Ziels.

AccessibilityOptions

Informationen zu den Optionen für Barrierefreiheit, die an einem Ort angeboten werden.

JSON-Darstellung
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Felder
wheelchairAccessibleParking

boolean

Der Ort bietet rollstuhlgerechte Parkplätze.

wheelchairAccessibleEntrance

boolean

Orte mit rollstuhlgerechtem Eingang.

wheelchairAccessibleRestroom

boolean

Rollstuhlgerechtes WC vorhanden

wheelchairAccessibleSeating

boolean

Der Ort verfügt über rollstuhlgerechte Sitzplätze.

FuelOptions

Die neuesten Informationen zu den Kraftstoffoptionen an einer Tankstelle. Diese Informationen werden regelmäßig aktualisiert.

JSON-Darstellung
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Felder
fuelPrices[]

object (FuelPrice)

Der letzte bekannte Kraftstoffpreis für jede Kraftstoffart, die an dieser Tankstelle angeboten wird. Für jeden Kraftstofftyp, der an dieser Tankstelle verfügbar ist, gibt es einen Eintrag. Die Reihenfolge spielt keine Rolle.

FuelPrice

Informationen zum Kraftstoffpreis für einen bestimmten Typ.

JSON-Darstellung
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Felder
type

enum (FuelType)

Der Kraftstofftyp.

price

object (Money)

Der Preis des Kraftstoffs.

updateTime

string (Timestamp format)

Der Zeitpunkt, zu dem der Kraftstoffpreis zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

FuelType

Kraftstoffarten.

Enums
FUEL_TYPE_UNSPECIFIED Nicht angegebener Kraftstofftyp.
DIESEL Dieselkraftstoff
DIESEL_PLUS Diesel Plus-Kraftstoff.
REGULAR_UNLEADED Normalbenzin
MIDGRADE Super
PREMIUM Ein Premium-Phone –
SP91 SP 91.
SP91_E10 SP 91 E10
SP92 SP 92.
SP95 SP 95
SP95_E10 SP95 E10
SP98 SP 98.
SP99 SP 99.
SP100 SP 100
LPG Flüssiggas
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Methan
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Lkw-Diesel.

Geld

Stellt einen Geldbetrag mit Währungstyp dar.

JSON-Darstellung
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Felder
currencyCode

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217

units

string (int64 format)

Die ganzen Einheiten des Betrags. Beispiel: Wenn currencyCode "USD" ist, dann entspricht eine Einheit 1 US-Dollar.

nanos

integer

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. -1,75 $ wird z. B. als units = −1 und nanos = −750.000.000 dargestellt.

EVChargeOptions

Informationen zur Ladestation für Elektrofahrzeuge, die am Ort gehostet wird. Die Terminologie folgt https://afdc.energy.gov/fuels/electricity_infrastructure.html. An einem Port kann jeweils nur ein Auto aufgeladen werden. Ein Port hat einen oder mehrere Anschlüsse. Eine Station hat einen oder mehrere Anschlüsse.

JSON-Darstellung
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Felder
connectorCount

integer

Anzahl der Anschlüsse an dieser Ladestation. Da einige Anschlüsse jedoch mehrere Stecker haben können, aber jeweils nur ein Auto gleichzeitig geladen werden kann, kann die Anzahl der Stecker größer sein als die Gesamtzahl der Autos, die gleichzeitig geladen werden können.

connectorAggregation[]

object (ConnectorAggregation)

Eine Liste von Aggregationen von Ladesteckern für Elektrofahrzeuge, die Steckverbinder desselben Typs und mit derselben Laderate enthalten.

ConnectorAggregation

Informationen zu Ladestationen für Elektrofahrzeuge, gruppiert nach [type, maxChargeRateKw]. Hier sehen Sie die aggregierten Daten für Ladestecker mit demselben Typ und derselben maximalen Laderate in kW.

JSON-Darstellung
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Felder
type

enum (EVConnectorType)

Der Connectortyp dieser Aggregation.

maxChargeRateKw

number

Die statische maximale Laderate in kW für jeden Anschluss in der Aggregation.

count

integer

Anzahl der Connectors in dieser Aggregation.

availabilityLastUpdateTime

string (Timestamp format)

Der Zeitstempel, zu dem die Informationen zur Verfügbarkeit des Connectors in dieser Aggregation zuletzt aktualisiert wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

availableCount

integer

Anzahl der Connectors in dieser Aggregation, die derzeit verfügbar sind.

outOfServiceCount

integer

Anzahl der Connectors in dieser Aggregation, die derzeit nicht in Betrieb sind.

EVConnectorType

Weitere Informationen zu den Anschlusstypen für das Laden von Elektrofahrzeugen finden Sie unter http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED Nicht angegebener Connector.
EV_CONNECTOR_TYPE_OTHER Andere Anschlusstypen
EV_CONNECTOR_TYPE_J1772 J1772-Stecker Typ 1
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 Typ 2-Anschluss Wird oft als MENNEKES bezeichnet.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO-Anschluss
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (Wechselstrom und Gleichstrom). Basierend auf SAE. J1772-Anschluss Typ 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (Wechselstrom und Gleichstrom). Basierend auf dem Typ-2-Mennekes-Stecker
EV_CONNECTOR_TYPE_TESLA Der generische TESLA-Connector. In Nordamerika ist das NACS, in anderen Teilen der Welt kann es sich aber auch um einen anderen Standard handeln, z.B. CCS Combo 2 (CCS2) oder GB/T. Dieser Wert ist weniger repräsentativ für einen tatsächlichen Steckertyp und gibt eher an, ob ein Fahrzeug der Marke Tesla an einer Ladestation von Tesla geladen werden kann.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Der GB/T-Typ entspricht dem GB/T-Standard in China. Dieser Typ umfasst alle GB_T-Typen.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Nicht angegebene Wandsteckdose.
EV_CONNECTOR_TYPE_NACS Das North American Charging System (NACS), standardisiert als SAE J3400.

GenerativeSummary

KI‑generierte Zusammenfassung des Orts.

JSON-Darstellung
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Felder
overview

object (LocalizedText)

Die Übersicht des Orts.

overviewFlagContentUri

string

Ein Link, über den Nutzer ein Problem mit der Übersichtszusammenfassung melden können.

disclosureText

object (LocalizedText)

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort erfolgt in der in der Anfrage angegebenen Sprache, sofern verfügbar.

ContainingPlace

Informationen zum Ort, an dem sich dieser Ort befindet.

JSON-Darstellung
{
  "name": string,
  "id": string
}
Felder
name

string

Der Ressourcenname des Orts, an dem sich dieser Ort befindet.

id

string

Die Orts-ID des Orts, an dem sich dieser Ort befindet.

AddressDescriptor

Eine relationale Beschreibung eines Standorts. Enthält eine sortierte Liste mit nahegelegenen Sehenswürdigkeiten und genauen umschließenden Gebieten sowie deren Beziehung zum Zielort.

JSON-Darstellung
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Felder
landmarks[]

object (Landmark)

Eine sortierte Liste von Sehenswürdigkeiten in der Nähe. Die bekanntesten und nächstgelegenen Sehenswürdigkeiten werden zuerst aufgeführt.

areas[]

object (Area)

Eine sortierte Liste mit angrenzenden oder benachbarten Bereichen. Die am besten erkennbaren und präzisesten Bereiche werden zuerst aufgeführt.

Sehenswürdigkeit

Grundlegende Informationen zum Orientierungspunkt und seine Beziehung zum Zielort.

Wahrzeichen sind bekannte Orte, die zur Beschreibung eines Standorts verwendet werden können.

JSON-Darstellung
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Felder
name

string

Der Ressourcenname des Orientierungspunkts.

placeId

string

Die Orts-ID des Wahrzeichens.

displayName

object (LocalizedText)

Der Anzeigename des Orientierungspunkts.

types[]

string

Eine Reihe von Typ-Tags für dieses Wahrzeichen. Eine vollständige Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types.

spatialRelationship

enum (SpatialRelationship)

Definiert die räumliche Beziehung zwischen dem Zielort und dem Orientierungspunkt.

straightLineDistanceMeters

number

Die Luftlinie zwischen dem Mittelpunkt des Ziels und dem Mittelpunkt des Orientierungspunkts in Metern. In einigen Fällen kann dieser Wert länger als travelDistanceMeters sein.

travelDistanceMeters

number

Die Entfernung in Metern entlang des Straßennetzes vom Ziel zum Orientierungspunkt, sofern bekannt. Bei diesem Wert wird die Art der Fortbewegung nicht berücksichtigt, z. B. zu Fuß, mit dem Auto oder mit dem Fahrrad.

SpatialRelationship

Definiert die räumliche Beziehung zwischen dem Zielort und dem Orientierungspunkt.

Enums
NEAR Dies ist die Standardbeziehung, wenn nichts Spezifischeres unten zutrifft.
WITHIN Das Landmark hat eine räumliche Geometrie und das Ziel liegt innerhalb seiner Grenzen.
BESIDE Das Ziel liegt direkt neben dem Orientierungspunkt.
ACROSS_THE_ROAD Das Ziel befindet sich direkt gegenüber dem Orientierungspunkt auf der anderen Straßenseite.
DOWN_THE_ROAD Auf derselben Route wie das Wahrzeichen, aber nicht daneben oder gegenüber.
AROUND_THE_CORNER Nicht auf derselben Route wie das Wahrzeichen, aber nur eine Abzweigung entfernt.
BEHIND In der Nähe des Gebäudes, aber weiter entfernt von den Eingängen.

Gebiet

Informationen zum Gebiet und zur Beziehung des Gebiets zum Zielort.

„Areas“ umfasst genaue Unterorte, Stadtteile und große Anlagen, die zur Beschreibung eines Orts nützlich sind.

JSON-Darstellung
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Felder
name

string

Der Ressourcenname des Bereichs.

placeId

string

Die Orts-ID des Gebiets.

displayName

object (LocalizedText)

Der Anzeigename des Bereichs.

containment

enum (Containment)

Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.

Eindämmung

Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.

Enums
CONTAINMENT_UNSPECIFIED Die Eindämmung ist nicht angegeben.
WITHIN Der Zielstandort befindet sich in der Region, in der Nähe des Zentrums.
OUTSKIRTS Der Zielstandort befindet sich in der Region, in der sich das Gebiet befindet, in der Nähe des Rands.
NEAR Der Zielort liegt außerhalb der Region, aber in der Nähe.

PriceRange

Die Preisspanne, die mit einem Ort verknüpft ist. endPrice kann nicht festgelegt sein, was auf einen Bereich ohne Obergrenze hinweist (z.B. „Mehr als 100 $“).

JSON-Darstellung
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Felder
startPrice

object (Money)

Das untere Ende der Preisspanne (einschließlich). Der Preis sollte mindestens diesem Betrag entsprechen.

endPrice

object (Money)

Das obere Ende der Preisspanne (exklusiv). Der Preis sollte niedriger als dieser Betrag sein.

ReviewSummary

KI‑generierte Zusammenfassung des Orts anhand von Nutzerrezensionen.

JSON-Darstellung
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
Felder
text

object (LocalizedText)

Zusammenfassung der Nutzerrezensionen

flagContentUri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosureText

object (LocalizedText)

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort erfolgt in der in der Anfrage angegebenen Sprache, sofern verfügbar.

reviewsUri

string

Ein Link, über den Sie Rezensionen zu diesem Ort in Google Maps aufrufen können.

EvChargeAmenitySummary

Die Zusammenfassung der Einrichtungen in der Nähe der Ladestation für Elektrofahrzeuge. Dies gilt nur für Orte vom Typ electric_vehicle_charging_station. Das Feld overview ist garantiert, die anderen Felder sind optional.

JSON-Darstellung
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Felder
overview

object (ContentBlock)

Eine Übersicht über die verfügbaren Ausstattungsmerkmale. Diese Informationen werden auf jeden Fall bereitgestellt.

coffee

object (ContentBlock)

Eine Zusammenfassung der Kaffeemöglichkeiten in der Nähe.

restaurant

object (ContentBlock)

Eine Zusammenfassung der Restaurants in der Nähe.

store

object (ContentBlock)

Eine Zusammenfassung der Geschäfte in der Nähe.

flagContentUri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosureText

object (LocalizedText)

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort erfolgt in der in der Anfrage angegebenen Sprache, sofern verfügbar.

ContentBlock

Ein Inhaltsblock, der einzeln ausgeliefert werden kann.

JSON-Darstellung
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
Felder
content

object (LocalizedText)

Inhalte, die sich auf das Thema beziehen.

referencedPlaces[]

string

Die Liste der Ressourcennamen der referenzierten Orte. Dieser Name kann in anderen APIs verwendet werden, die Ressourcennamen für Orte akzeptieren.

NeighborhoodSummary

Eine Zusammenfassung der Sehenswürdigkeiten in der Nähe des Ortes.

JSON-Darstellung
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Felder
overview

object (ContentBlock)

Eine Übersicht über die Nachbarschaft.

description

object (ContentBlock)

Eine detaillierte Beschreibung der Nachbarschaft.

flagContentUri

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.

disclosureText

object (LocalizedText)

Die KI-Offenlegungsmeldung „Zusammengefasst mit Gemini“ (und ihre lokalisierten Varianten). Die Antwort erfolgt in der in der Anfrage angegebenen Sprache, sofern verfügbar.

Methoden

autocomplete

Gibt Vorhersagen für die angegebene Eingabe zurück.

get

Rufen Sie die Details eines Orts anhand seines Ressourcennamens ab. Das ist ein String im Format places/{place_id}.

searchNearby

Orte in der Nähe von Orten suchen

searchText

Ortssuche auf Grundlage einer Textabfrage.