Dieses Produkt oder diese Funktion ist eingestellt. Weitere Informationen zum Status „Alt“ finden Sie unter Alte Produkte und Funktionen. Informationen zur Migration zur Places API (neu) finden Sie im Migrationsleitfaden.

Find Place (alt)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Hinweis: Serverseitige und clientseitige Bibliotheken

Die Places API ist auch mit dem Java-Client, Python-Client, Go-Client und Node.js-Client für Google Maps-Dienste verfügbar. Die Places API und die Clientbibliotheken sind für die Verwendung in Serveranwendungen vorgesehen.

Wenn Sie eine clientseitige Anwendung entwickeln, sehen Sie sich das Places SDK for Android (New), das Places SDK for iOS (New) und die Places Library, Maps JavaScript API an.

Bei Anfragen vom Typ „Find Place (Legacy)“ geben Sie Text ein und es wird ein Ort zurückgegeben. Als Eingabe können alle Arten von Places-Textdaten verwendet werden, z. B. Namen, Adressen oder Telefonnummern. Die Anfrage muss ein String sein. Eine „Find Place (Legacy)“-Anfrage mit Daten, die keine Strings sind, z. B. Breiten-/Längengradkoordinaten oder Plus Codes, führt zu einem Fehler.

Bei einer „Find Place (Legacy)“-Anfrage wird ein Teil der Felder zurückgegeben, die bei einer „Place Details (Legacy)“-Anfrage zurückgegeben werden. Weitere Informationen zu den Feldern, die in einer Find Place (Legacy)-Anfrage nicht verfügbar sind, finden Sie unter Unterstützung von Places API-Feldern. Wenn das gewünschte Feld nicht zurückgegeben wird, können Sie mit „Find Place (Legacy)“ eine place_id abrufen und diese ID dann für eine „Place Details (Legacy)“-Anfrage verwenden.

„Find Place“-Anfragen (Legacy)

Eine „Find Place (Legacy)“-Anfrage ist eine HTTP-URL im folgenden Format:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

Dabei kann output einen der folgenden Werte haben:

json (empfohlen) gibt die Ausgabe in JavaScript Object Notation (JSON) an.
xml gibt die Ausgabe als XML an.

Für eine „Find Place (Legacy)“-Anfrage sind bestimmte Parameter erforderlich. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt.

Erforderliche Parameter

Eingabe

Der Textstring, nach dem gesucht werden soll, z. B. „Restaurant“ oder „Hauptstraße 60“. Der Textstring muss dabei der Name oder die Adresse eines Ortes oder die Art eines Betriebs oder Unternehmens sein. Alle anderen Arten von Eingaben führen vermutlich zu einem Fehler und die zurückgegebenen Ergebnisse sind möglicherweise ungültig. Über die Places API werden mögliche Übereinstimmungen basierend auf dem String zurückgegeben, die nach erkannter Relevanz sortiert werden.
inputtype

Der Typ der Eingabe. Dies kann entweder textquery oder phonenumber sein. Telefonnummern müssen im internationalen Format angegeben werden (ein Pluszeichen „+“, gefolgt von der Ländervorwahl und dann der Telefonnummer selbst). Weitere Informationen finden Sie in der ITU-Empfehlung E.164.

Optionale Parameter

Felder

Achtung:Bei Place Search- und Place Details-Anfragen werden nicht die gleichen Felder zurückgegeben. Bei Place Search-Anfragen wird jeweils ein Teil der Felder zurückgegeben, die bei Place Details-Anfragen zurückgegeben werden. Wenn das gewünschte Feld bei einer „Place Search“-Anfrage nicht zurückgegeben wird, können Sie mit „Place Search“ eine place_id abrufen und diese ID dann für eine „Place Details“-Anfrage verwenden. Weitere Informationen zu den Feldern, die in einer Place Search-Anfrage nicht verfügbar sind, finden Sie unter Unterstützung von Places API-Feldern.

Verwenden Sie den Parameter „fields“, um eine durch Kommas getrennte Liste der zurückzugebenden Ortsdatentypen anzugeben. Beispiel: fields=formatted_address,name,geometry. Verwenden Sie bei zusammengesetzten Werten einen Schrägstrich. Beispiel: opening_hours/open_now.

Die Felder sind in drei Abrechnungskategorien unterteilt: Basic, Contact und Atmosphere. Für Felder der Kategorie „Basic“ gilt der Basispreis. Für Felder der Kategorie „Contact“ und „Atmosphere“ werden höhere Kosten abgerechnet. Die SKUs „Basic“, „Contact“ und „Atmosphere“ werden zusätzlich zur Basis-SKU („Places Details“, „Find Place“, „Nearby Search“ oder „Text Search“) für die Anfrage in Rechnung gestellt, die sie ausgelöst hat. Weitere Informationen finden Sie im Preisblatt.

Basic

Die Kategorie „Basic“ umfasst folgende Felder: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (eingestellt), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

Kontakt

Die Kategorie „Contact“ umfasst folgende Felder: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

Atmosphere

Die Kategorie „Atmosphere“ umfasst folgende Felder: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

Hinweis:Quellenangaben (html_attributions) werden bei jedem Aufruf zurückgegeben, unabhängig davon, ob das Feld angefordert wurde.
Sprache

Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert. Diese Liste ist daher möglicherweise nicht vollständig.
- Wenn language nicht angegeben ist, versucht die API, die bevorzugte Sprache zu verwenden, die im Accept-Language-Header angegeben ist.
- Die API versucht, eine Straßenadresse bereitzustellen, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Straßenadressen in der lokalen Sprache zurückgegeben, die bei Bedarf in ein für den Nutzer lesbares Schriftsystem transliteriert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die anhand der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, wird die nächstgelegene Übereinstimmung verwendet.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, und auf die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht. Beispiel: utca und tér sind Synonyme für „Straße“ auf Ungarisch.
locationbias

Sie können Ergebnisse in einem bestimmten Bereich bevorzugen, indem Sie entweder einen Radius plus Breiten-/Längengrad oder zwei Breiten-/Längengradpaare angeben, die die Punkte eines Rechtecks darstellen. Wenn dieser Parameter nicht angegeben ist, verwendet die API standardmäßig die IP-Adressen-Gewichtung.
- IP-Bias: Weist die API an, IP-Adressen-Bias zu verwenden. Übergeben Sie den String ipbias (für diese Option sind keine zusätzlichen Parameter erforderlich).
- Kreisförmig: Ein String, der den Radius in Metern sowie den Breiten- und Längengrad in Dezimalgrad angibt. Verwenden Sie das folgende Format: circle:radius@lat,lng.
- Rechteckig: Ein String mit zwei Breiten-/Längenkoordinatenpaaren in Dezimalgrad, die die südwestlichen und nordöstlichen Punkte eines Rechtecks darstellen. Verwenden Sie das folgende Format:rectangle:south,west|north,east. Hinweis: Ost-/West-Werte werden auf den Bereich -180, 180 begrenzt und Nord-/Süd-Werte auf den Bereich -90, 90.

Hinweis:Wenn Sie den Parameter fields in einer Find Place (Legacy)-Anfrage weglassen, wird nur die place_id für das Ergebnis zurückgegeben.

Beispiele für „Find Place“ (Legacy)

Das folgende Beispiel zeigt eine Find Place-Anfrage (Legacy) für das „Museum of Contemporary Art Australia“, die die Felder photos, formatted_address, name, rating, opening_hours und geometry enthält:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Das folgende Beispiel zeigt eine „Find Place (Legacy)“-Anfrage für „Mongolian Grill“, bei der mit dem Parameter locationbias Ergebnisse im Umkreis von 2.000 Metern um die angegebenen Koordinaten bevorzugt werden:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Das folgende Beispiel zeigt eine „Find Place“-Anfrage (Legacy) für eine Telefonnummer. Das internationale Anrufpräfix „+“ wurde in %2B codiert, damit diese Anfrage eine konforme URL ist. Wenn das Pluszeichen nicht codiert wird, wird es auf dem Server als Leerzeichen decodiert, was zu einer ungültigen Telefonnummer führt.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

„Find Place (Legacy)“-Antworten

Eine „Find Place (Legacy)“-Antwort enthält nur die Datentypen, die mit dem Parameter fields angegeben wurden, sowie html_attributions. Im folgenden Beispiel sehen Sie die Antwort auf eine Find Place-Anfrage (Legacy) für das „Museum of Contemporary Art Australia“, die die Felder formatted_address, geometry, name, opening_hours, photos und rating enthält.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Feld	Erforderlich	Typ	Beschreibung
`candidates`	required	Array<Place>	Enthält ein Array mit vorgeschlagenen Orten. Bei Place Search-Anfragen wird eine Teilmenge der Felder zurückgegeben, die bei Place Details-Anfragen zurückgegeben werden. Wenn das gewünschte Feld bei einer „Place Search“-Anfrage nicht zurückgegeben wird, können Sie mit „Place Search“ eine place_id abrufen und diese ID dann für eine „Place Details“-Anfrage verwenden. Weitere Informationen finden Sie unter Ort.
`status`	required	PlacesSearchStatus	Enthält den Status der Anfrage und möglicherweise Debugging-Informationen, mit deren Hilfe Sie herausfinden können, warum die Anfrage fehlgeschlagen ist. Weitere Informationen finden Sie unter PlacesSearchStatus.
`error_message`	optional	String	Wenn der Dienst einen anderen Statuscode als `OK<` zurückgibt, kann das Antwortobjekt ein zusätzliches Feld `error_message` enthalten. Dieses Feld enthält detailliertere Informationen zu den Gründen für den angegebenen Statuscode. Dieses Feld wird nicht immer zurückgegeben und sein Inhalt kann sich ändern.
`info_messages`	optional	Array<string>	Wenn der Dienst zusätzliche Informationen zur Anfragespezifikation zurückgibt, kann im Antwortobjekt ein zusätzliches `info_messages`-Feld vorhanden sein. Dieses Feld wird nur für erfolgreiche Anfragen zurückgegeben. Es wird möglicherweise nicht immer zurückgegeben und sein Inhalt kann sich ändern.

PlacesSearchStatus

Statuscodes, die vom Dienst zurückgegeben werden.

OK: Die API-Anfrage war erfolgreich.
ZERO_RESULTS gibt an, dass die Suche erfolgreich war, aber keine Ergebnisse zurückgegeben wurden. Dieser Status kann ausgegeben werden, wenn der Suche ein latlng-Element an einem Remote-Standort übergeben wurde.
INVALID_REQUEST: Die API-Anfrage war fehlerhaft, in der Regel aufgrund eines fehlenden erforderlichen Abfrageparameters (location oder radius).
OVER_QUERY_LIMIT, die Folgendes angibt:
- Sie haben die Limits für die maximal zulässige Anzahl von Abfragen pro Sekunde überschritten.
- Die Abrechnung wurde für Ihr Konto nicht aktiviert.
- Das monatliche Guthaben von 200 $oder das von Ihnen festgelegte Nutzungslimit wurde überschritten.
- Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
Weitere Informationen zum Beheben dieses Fehlers finden Sie in den häufig gestellten Fragen zu Maps.
REQUEST_DENIED gibt an, dass Ihre Anfrage abgelehnt wurde. Das liegt in der Regel daran, dass:
- In der Anfrage fehlt ein API-Schlüssel.
- Der Parameter key ist ungültig.
UNKNOWN_ERROR: Ein unbekannter Fehler ist aufgetreten.

Ort

Attribute, die einen Ort beschreiben. Nicht alle Attribute sind für alle Arten von Orten verfügbar.

Feld	Erforderlich	Typ	Beschreibung
`address_components`	optional	Array<`AddressComponent`>	Ein Array, das die einzelnen Komponenten für diese Adresse enthält. Weitere Informationen finden Sie unter `AddressComponent`.
`adr_address`	optional	String	Eine Darstellung der Adresse des Orts im adr-Mikroformat.
`business_status`	optional	String	Gibt den Öffnungsstatus des Ortes an, sofern es sich um ein Unternehmen handelt. Wenn keine Daten vorhanden sind, wird für `business_status` kein Wert zurückgegeben. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	optional	boolean	Gibt an, ob das Unternehmen die Abholung vor dem Geschäft unterstützt.
`current_opening_hours`	optional	PlaceOpeningHours	Enthält 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 `special_days` für alle Stunden, die für Daten mit Sonderöffnungszeiten festgelegt sind. Weitere Informationen finden Sie unter PlaceOpeningHours.
`delivery`	optional	boolean	Gibt an, ob das Unternehmen einen Lieferservice anbietet.
`dine_in`	optional	boolean	Gibt an, ob das Unternehmen Sitzplätze im Innen- oder Außenbereich anbietet.
`editorial_summary`	optional	PlaceEditorialSummary	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 modifiziert oder geändert werden. Weitere Informationen finden Sie unter PlaceEditorialSummary.
`formatted_address`	optional	String	Ein String, der die Adresse dieses Orts in lesbarer Form enthält. Diese Adresse stimmt häufig mit der Postanschrift überein. In einigen Ländern, z. B. dem Vereinigten Königreich, ist die Weitergabe echter Postanschriften aufgrund von Lizenzeinschränkungen nicht zulässig. Die formatierte Adresse besteht aus einer oder mehreren Adresskomponenten. Die Adresse „111 8th Avenue, New York, NY“ besteht z. B. aus den folgenden Komponenten: „111“ (Hausnummer), „8th Avenue“ (Straße), „New York“ (Stadt) und „NY“ (US-Bundesstaat). Wir raten davon ab, die formatierte Adresse programmatisch zu parsen. Verwenden Sie stattdessen die einzelnen Adresskomponenten, die zusätzlich zur formatierten Adresse in der API-Antwort enthalten sind.
`formatted_phone_number`	optional	String	Enthält die Telefonnummer des Orts im lokalen Format.
`geometry`	optional	`Geometry`	Enthält den Standort und den Darstellungsbereich für den Standort. Weitere Informationen findest du unter `Geometry`.
`icon`	optional	String	Enthält die URL eines vorgeschlagenen Symbols, das dem Nutzer möglicherweise angezeigt wird, wenn dieses Ergebnis auf einer Karte dargestellt wird.
`icon_background_color`	optional	String	Enthält den standardmäßigen Hex-Farbcode für die Kategorie des Orts.
`icon_mask_base_uri`	optional	String	Enthält die URL eines empfohlenen Symbols ohne die Dateityperweiterung `.svg` oder `.png`.
`international_phone_number`	optional	String	Enthält die Telefonnummer des Orts im internationalen Format. Das internationale Format umfasst die Ländervorwahl mit einem vorangestellten Pluszeichen (+). Die international_phone_number für die Google-Niederlassung in Sydney, Australien, ist z. B. `+61 2 9374 4000`.
`name`	optional	String	Enthält den für Menschen lesbaren Namen für das zurückgegebene Ergebnis. Bei `establishment`-Ergebnissen ist das in der Regel der kanonisierte Unternehmensname.
`opening_hours`	optional	PlaceOpeningHours	Enthält die regulären Öffnungszeiten. Weitere Informationen finden Sie unter PlaceOpeningHours.
`permanently_closed`	optional	boolean	`permanently_closed` wurde eingestellt. Verwenden Sie `business_status`, um den Öffnungsstatus von Unternehmen abzurufen.
`photos`	optional	Array<PlacePhoto>	Ein Array von Fotoobjekten, die jeweils einen Verweis auf ein Bild enthalten. Bei einer Anfrage können bis zu zehn Fotos zurückgegeben werden. Weitere Informationen zu Ortsfotos und dazu, wie Sie die Bilder in Ihrer Anwendung verwenden können, finden Sie in der Dokumentation zu Ortsfotos. Weitere Informationen finden Sie unter PlacePhoto.
`place_id`	optional	String	Eine ID in Textform, die einen Ort eindeutig bezeichnet. Wenn Sie Informationen zum Ort abrufen möchten, geben Sie diese ID im Feld `place_id` einer Places API-Anfrage weiter. Weitere Informationen zu Orts-IDs finden Sie in der Übersicht zur Orts-ID.
`plus_code`	optional	`PlusCode`	Ein codierter Verweis auf den Standort, der sich aus den Koordinaten (Breiten- und Längengrad) ableiten lässt und einen Bereich definiert: 1/8.000stel eines Grades mal 1/8.000stel eines Grades (ca. 14 m × 14 m am Äquator) oder kleiner. 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. Weitere Informationen finden Sie unter Open Location Code und Plus Codes. Weitere Informationen findest du unter `PlusCode`.
`price_level`	optional	Zahl	Das Preisniveau des Orts auf einer Skala von 0 bis 4. Der genaue Betrag, der durch einen bestimmten Wert angegeben wird, variiert je nach Region. Die Preisniveaus werden so interpretiert: 0 Kostenlos 1 Günstig 2 Mittel 3 Teuer 4 Sehr teuer
`rating`	optional	Zahl	Enthält die Bewertung des Orts. Sie beruht auf aggregierten Nutzerrezensionen und liegt zwischen 1, 0 und 5, 0.
`reference`	optional	String	`reference` wurde eingestellt.
`reservable`	optional	boolean	Gibt an, ob für den Ort Reservierungen möglich sind.
`reviews`	optional	Array<PlaceReview>	Ein JSON-Array mit bis zu fünf Rezensionen. Standardmäßig werden die Rezensionen nach Relevanz sortiert. Verwenden Sie den Anfrageparameter `reviews_sort`, um die Sortierung zu steuern. Bei `most_relevant` (Standard) werden Rezensionen nach Relevanz sortiert. Der Dienst gewichtet die Ergebnisse so, dass Rezensionen zurückgegeben werden, die ursprünglich in der bevorzugten Sprache verfasst wurden. Bei `newest` werden Rezensionen in chronologischer Reihenfolge sortiert. Die bevorzugte Sprache hat keinen Einfluss auf die Sortierreihenfolge. Google empfiehlt, Nutzern mitzuteilen, ob die Ergebnisse nach `most_relevant` oder `newest` sortiert sind. Weitere Informationen finden Sie unter PlaceReview.
`scope`	optional	String	`scope` wurde eingestellt.
`secondary_opening_hours`	optional	Array<PlaceOpeningHours>	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. Die Daten dafür stammen aus einer vordefinierten Liste von Öffnungszeiten-Typen (z. B. `DRIVE_THROUGH`, `PICKUP` oder `TAKEOUT`), die auf den Typen des Orts basieren. Dieses Feld enthält das Unterfeld `special_days` für alle Stunden, die für Datumsangaben mit Sonderöffnungszeiten festgelegt sind. Weitere Informationen finden Sie unter PlaceOpeningHours.
`serves_beer`	optional	boolean	Gibt an, ob an diesem Ort Bier ausgeschenkt wird.
`serves_breakfast`	optional	boolean	Gibt an, ob an diesem Ort Frühstück serviert wird.
`serves_brunch`	optional	boolean	Gibt an, ob an diesem Ort Brunch angeboten wird.
`serves_dinner`	optional	boolean	Gibt an, ob an diesem Ort Abendessen serviert wird.
`serves_lunch`	optional	boolean	Gibt an, ob an diesem Ort Mittagessen serviert wird.
`serves_vegetarian_food`	optional	boolean	Gibt an, ob an diesem Ort vegetarische Speisen serviert werden.
`serves_wine`	optional	boolean	Gibt an, ob an diesem Ort Wein ausgeschenkt wird.
`takeout`	optional	boolean	Gibt an, ob das Unternehmen Essen zum Mitnehmen anbietet.
`types`	optional	Array<string>	Enthält ein Array mit Elementtypen, die das angegebene Ergebnis beschreiben. Sehen Sie sich die Liste der unterstützten Typen an.
`url`	optional	String	Enthält die URL der offiziellen Google-Seite für diesen Ort. Es handelt sich dabei um die Google-eigene Seite, die die bestmöglichen Informationen zum Ort enthält. In Anwendungen muss diese Seite verlinkt oder eingebettet sein und zwar auf jedem Bildschirm, auf dem detaillierte Ergebnisse zu diesem Ort für den Nutzer angezeigt werden.
`user_ratings_total`	optional	Zahl	Die Gesamtzahl der Rezensionen (mit oder ohne Text) für diesen Ort.
`utc_offset`	optional	Zahl	Enthält die Anzahl der Minuten, um die die aktuelle Zeitzone dieses Orts von UTC abweicht. Für Orte in Sydney, Australien, während der Sommerzeit wäre das beispielsweise 660 (+11 Stunden ab UTC) und für Orte in Kalifornien außerhalb der Sommerzeit -480 (-8 Stunden ab UTC).
`vicinity`	optional	String	Bei Ergebnissen für Unternehmen (`types:["establishment", ...])`) enthält das Feld `vicinity` eine vereinfachte Adresse des Ortes, einschließlich Straße, Hausnummer und Verwaltungseinheit, aber ohne Provinz/Bundesland, Postleitzahl oder Land. Bei allen anderen Ergebnissen enthält das Feld `vicinity` den Namen des engsten politischen (`types:["political", ...]`) Merkmals, das in der Adresse des Ergebnisses vorhanden ist. Dieser Inhalt ist so zu lesen, wie er ist. Die formatierte Adresse darf nicht programmatisch geparst werden.
`website`	optional	String	Die offizielle Website des Ortes, z. B. die Homepage eines Unternehmens.
`wheelchair_accessible_entrance`	optional	boolean	Gibt an, ob der Ort einen rollstuhlgerechten Eingang hat.

PlaceEditorialSummary

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

Feld	Erforderlich	Typ	Beschreibung
`language`	optional	String	Die Sprache der vorherigen Felder. Muss nicht immer vorhanden sein.
`overview`	optional	String	Eine mittellange Textzusammenfassung des Orts.

PlaceOpeningHours

Ein Objekt, das die Öffnungszeiten eines Orts beschreibt.

Feld	Erforderlich	Typ	Beschreibung
`open_now`	optional	boolean	Ein boolescher Wert, der angibt, ob der Ort derzeit geöffnet ist.
`periods`	optional	Array<PlaceOpeningHoursPeriod>	Ein Array mit Öffnungszeiten in einem Zeitraum von 7 Tagen in chronologischer Reihenfolge, beginnend am Sonntag. Weitere Informationen finden Sie unter PlaceOpeningHoursPeriod.
`special_days`	optional	Array<PlaceSpecialDay>	Ein Array mit bis zu sieben Einträgen, die den nächsten sieben Tagen entsprechen. Weitere Informationen finden Sie unter PlaceSpecialDay.
`type`	optional	String	Ein Typstring zur Identifizierung des Typs der sekundären Öffnungszeiten (z. B. `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`). Nur für `secondary_opening_hours` festgelegt.
`weekday_text`	optional	Array<string>	Ein Array von Strings, das die Öffnungszeiten des Orts in für Menschen lesbarem Text beschreibt.

PlaceOpeningHoursPeriod

Feld	Erforderlich	Typ	Beschreibung
`open`	required	PlaceOpeningHoursPeriodDetail	Enthält ein Paar aus Tages- und Zeitobjekten, die beschreiben, wann der Ort geöffnet hat. Weitere Informationen finden Sie unter PlaceOpeningHoursPeriodDetail.
`close`	optional	PlaceOpeningHoursPeriodDetail	Kann ein Paar aus Tages- und Zeitobjekten enthalten, die beschreiben, wann der Ort geschlossen hat. Wenn ein Ort durchgängig geöffnet ist, fehlt der Abschnitt „Schließen“ in der Antwort. Ist der Ort immer geöffnet, wird in der Anwendung der Zeitraum „Geöffnet“ mit dem Tag mit dem Wert `0` und der Uhrzeit mit dem Wert `0000` dargestellt. `close` ist dann nicht vorhanden. Weitere Informationen finden Sie unter PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Feld	Erforderlich	Typ	Beschreibung
`date`	optional	String	Ein Datum im RFC3339-Format in der lokalen Zeitzone des Orts, z. B. 2010-12-31.
`exceptional_hours`	optional	boolean	„True“, wenn es für diesen Tag besondere Öffnungszeiten gibt. Wenn `true`, bedeutet das, dass es für diesen Tag mindestens eine Ausnahme gibt. Ausnahmen führen dazu, dass in den Unterfeldern von `current_opening_hours` und `secondary_opening_hours` unterschiedliche Werte auftreten, z. B. `periods`, `weekday_text` und `open_now`. Die Ausnahmen gelten für die Öffnungszeiten und die Öffnungszeiten werden verwendet, um die anderen Felder zu generieren.

PlaceOpeningHoursPeriodDetail

Feld	Erforderlich	Typ	Beschreibung
`day`	erforderlich	Zahl	Eine Zahl von 0 bis 6, die dem Wochentag entspricht, beginnend mit Sonntag. Beispiel: 2 bedeutet Dienstag.
`time`	required	String	Kann eine Uhrzeit im 24‑Stunden-Format (hhmm) enthalten. Die Werte liegen im Bereich 0000–2359. Die Zeit wird in der Zeitzone des Ortes angegeben.
`date`	optional	String	Ein Datum im RFC3339-Format in der lokalen Zeitzone des Orts, z. B. 2010-12-31.
`truncated`	optional	boolean	„True“, wenn ein bestimmter Zeitraum aufgrund einer Beschränkung auf sieben Tage gekürzt wurde. Der Zeitraum beginnt vor Mitternacht am Datum der Anfrage und/oder endet um Mitternacht oder danach am letzten Tag. Diese Property gibt an, dass sich der Zeitraum für „Geöffnet“ oder „Geschlossen“ über diese siebentägige Frist hinaus erstrecken kann.

PlacePhoto

Ein Foto eines Orts. Auf das Foto kann über die Place Photo API mit einer URL im folgenden Muster zugegriffen werden:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Weitere Informationen finden Sie unter Ortsfotos.

Feld	Erforderlich	Typ	Beschreibung
`height`	erforderlich	Zahl	Die Höhe des Fotos.
`html_attributions`	required	Array<string>	Die HTML-Quellenangaben für das Foto.
`photo_reference`	required	String	Ein String, mit dem das Foto identifiziert wird, wenn Sie eine Fotoanfrage stellen.
`width`	required	Zahl	Die Breite des Fotos.

PlaceReview

Eine von einem Nutzer eingereichte Rezension des Orts.

Feld	Erforderlich	Typ	Beschreibung
`author_name`	erforderlich	String	Der Name des Nutzers, der die Rezension geschrieben hat. Anonyme Rezensionen werden mit „Ein Google-Nutzer“ gekennzeichnet.
`rating`	required	Zahl	Die Gesamtbewertung des Nutzers für diesen Ort. Der Wert wird als Ganzzahl zwischen 1 und 5 angegeben.
`relative_time_description`	required	String	Der Zeitpunkt, zu dem die Rezension eingereicht wurde, als Text relativ zur aktuellen Zeit.
`time`	required	Zahl	Der Zeitpunkt, zu dem die Rezension eingereicht wurde, gemessen in Sekunden seit Mitternacht am 1. Januar 1970 (UTC).
`author_url`	optional	String	Die URL des Google Maps Local Guides-Profils des Nutzers, sofern verfügbar.
`language`	optional	String	Ein IETF-Sprachcode, der die Sprache der zurückgegebenen Rezension angibt.Dieses Feld enthält nur das primäre Tag für die Sprache, nicht das sekundäre Tag für Land oder Region. Alle englischsprachigen Rezensionen erhalten z. B. das Tag „en“ und nicht „en-AU“ oder „en-UK“ usw. Dieses Feld ist leer, wenn nur eine Bewertung ohne Rezensionstext vorhanden ist.
`original_language`	optional	String	Ein IETF-Sprachcode, der die Originalsprache der Rezension angibt. Wenn die Rezension übersetzt wurde, gilt `original_language` != `language`.Dieses Feld enthält nur das primäre Tag für die Sprache, nicht das sekundäre Tag für Land oder Region. Alle englischsprachigen Rezensionen erhalten z. B. das Tag „en“ und nicht „en-AU“ oder „en-UK“ usw. Dieses Feld ist leer, wenn nur eine Bewertung ohne Rezensionstext vorhanden ist.
`profile_photo_url`	optional	String	Die URL zum Profilbild des Nutzers, falls verfügbar.
`text`	optional	String	Die Rezension des Nutzers. Wenn Sie eine Rezension für einen Ort in Google Places erstellen, sind Rezensionen in Textform optional. Daher kann dieses Feld leer sein. Dieses Feld kann einfaches HTML-Markup enthalten. Die Entitätsreferenz `&` kann beispielsweise ein kaufmännisches Und darstellen.
`translated`	optional	boolean	Ein boolescher Wert, der angibt, ob die Rezension aus der Originalsprache übersetzt wurde, in der sie verfasst wurde.Wenn eine Rezension übersetzt wurde (entsprechend dem Wert „true“), empfiehlt Google, dass Sie dies Ihren Nutzern mitteilen. Sie können der Rezension beispielsweise den folgenden String hinzufügen: „Übersetzt von Google“.

Find Place (alt) Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

„Find Place“-Anfragen (Legacy)

Erforderliche Parameter

Eingabe

inputtype

Optionale Parameter

Felder

Sprache

locationbias

Beispiele für „Find Place“ (Legacy)

curl

HTTP

curl

HTTP

curl

HTTP

„Find Place (Legacy)“-Antworten

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

Ort

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

Find Place (alt)

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`