Find Place (alt)

Bei einer „Find Place (Legacy)“-Anfrage geben Sie Text ein und es wird ein Ort zurückgegeben. Die Eingabe kann eine beliebige Art von Textdaten zu einem Ort sein, z. B. ein Name, eine Adresse oder eine Telefonnummer. Die Anfrage muss ein String sein. Eine „Find Place (Legacy)“-Anfrage mit Nicht-String-Daten wie Breiten-/Längengradkoordinaten oder Plus Codes führt zu einem Fehler.

„Find Place (Legacy)“-Anfragen

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 einer der folgenden Werte sein:

• 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. Der Textstring muss dabei der Name, die Adresse oder die Telefonnummer eines Ortes sein, z. B. „Hauptstraße 123“ oder „Rathaus“.

• 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 (Legacy)- und Place Details (Legacy)-Anfragen werden nicht die gleichen Felder zurückgegeben. Bei Place Search-Anfragen (Legacy) werden weniger Felder zurückgegeben als bei Place Details-Anfragen (Legacy). Wenn das gewünschte Feld bei einer „Place Search“ (Legacy)-Anfrage nicht zurückgegeben wird, können Sie mit „Place Search“ (Legacy) eine place_id abrufen und diese Orts-ID dann für eine „Place Details“ (Legacy)-Anfrage verwenden. Weitere Informationen zu den Feldern, die in einer Place Search-Anfrage (Legacy) nicht verfügbar sind, finden Sie unter Unterstützung von Places API-Feldern.

  Verwenden Sie den Parameter „fields“, um eine durch Kommas getrennte Liste von Ortsdatentypen anzugeben, die zurückgegeben werden sollen. 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 Kategorien „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 berechnet, durch die sie ausgelöst wurden. Weitere Informationen finden Sie in der Preisübersicht.

  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:Zuordnungen (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, sodass diese Liste unter Umständen nicht vollständig ist.
  • Wenn language nicht angegeben ist, versucht die API, die im Header Accept-Language angegebene bevorzugte Sprache zu verwenden.
  • Die API versucht, eine Adresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Adressen in der Landessprache zurückgegeben, die bei Bedarf in eine für den Nutzer lesbare Schrift transkribiert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die von der ersten Komponente ausgewählt wird.
  • Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API die nächstgelegene Übereinstimmung.
  • Die bevorzugte Sprache hat einen geringen Einfluss auf die von der API zurückgegebenen Ergebnisse und 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 sind, in einer anderen jedoch nicht. Beispiel: utca und tér sind ungarische Synonyme für „Straße“.

• locationbias

  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-Adressgewichtung.

  • IP-Bias: Weist die API an, die IP-Adresse zu berücksichtigen. Übergeben Sie den String ipbias (diese Option hat keine zusätzlichen Parameter).
  • 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, der zwei Paare aus Breiten-/Längenkoordinaten in Dezimalgrad angibt, die die südwestlichen und nordöstlichen Punkte eines Rechtecks darstellen. Verwenden Sie das folgende Format:rectangle:south,west|north,east. Beachten Sie, dass Ost-/Westwerte auf den Bereich -180, 180 und Nord-/Südwerte auf den Bereich -90, 90 beschränkt sind.

Beispiele für „Find Place (Legacy)“

Das folgende Beispiel zeigt eine „Find Place (Legacy)“-Anfrage für „Museum of Contemporary Art Australia“ mit den Feldern photos, formatted_address, name, rating, opening_hours und geometry:

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'

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“. Mit dem Parameter locationbias werden Ergebnisse im Umkreis von 2.000 Metern um die angegebenen Koordinaten bevorzugt:

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'

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 (Legacy)“-Anfrage für eine Telefonnummer. Beachten Sie, dass die internationale Vorwahl „+“ als %2B codiert wurde, damit diese Anfrage eine konforme URL ist. Wenn das Präfix „+“ nicht codiert wird, wird es auf dem Server als Leerzeichen decodiert, was zu einer ungültigen Telefonnummernsuche führt.

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'

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. Das folgende Beispiel zeigt die Antwort auf eine „Find Place (Legacy)“-Anfrage für „Museum of Contemporary Art Australia“, einschließlich der Felder formatted_address, geometry, name, opening_hours, photos und rating.

{
  "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 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

PlacesSearchStatus

Vom Dienst zurückgegebene Statuscodes.

• 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 entfernten Ort übergeben wurde.
• INVALID_REQUEST: Die API-Anfrage war fehlerhaft, in der Regel aufgrund eines fehlenden erforderlichen Suchparameters (location oder radius).
• OVER_QUERY_LIMIT, der auf Folgendes hinweist:
  • Sie haben 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 ein von Ihnen festgelegtes Nutzungslimit wurde überschritten.
  • Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
  Weitere Informationen zur Behebung dieses Fehlers finden Sie in den FAQs zu Maps.
• REQUEST_DENIED gibt an, dass Ihre Anfrage abgelehnt wurde, im Allgemeinen aus folgenden Gründen:
  • In der Anfrage fehlt ein API-Schlüssel.
  • Der Parameter key ist ungültig.
• UNKNOWN_ERROR: Ein unbekannter Fehler ist aufgetreten.

Ort

Bei Place Search-Anfragen wird die folgende Teilmenge der Place-Felder zurückgegeben. Nicht alle Attribute sind für alle Ortstypen verfügbar. Wenn Sie Felder abrufen möchten, die von Place Search nicht zurückgegeben werden, z. B. address_components, formatted_phone_number, reviews oder website, übergeben Sie die zurückgegebene place_id in einer Place Details (Legacy)-Anfrage. Informationen zur Verfügbarkeit von Feldern und zu den Preisstufen für die einzelnen Endpunkte finden Sie unter Ortsdatenfelder (Legacy).