Dieses Produkt hat den Legacy-Status. Ab Oktober 2026 kann die Places API (Legacy) nicht mehr für neue Google Cloud-Projekte aktiviert werden. Bestehende Projekte werden weiterhin vollständig unterstützt. Wenn Sie neue Funktionen nutzen und die Leistung verbessern möchten, migrieren Sie zur Places API (New).

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Text Search (Legacy)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Hinweis: Serverseitige und clientseitige Bibliotheken

Die Places API ist auch mit dem Java-, Python-, Go- 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 erstellen, sehen Sie sich das Places SDK for Android (New), das Places SDK for iOS (New) und die Places Library, Maps JavaScript API an.

Bei Verwendung von „Text Search (Legacy)“ werden Informationen zu verschiedenen Orten auf Grundlage eines Textstrings zurückgegeben, z. B. „Pizza in München“, „Schuhgeschäfte in der Nähe von Hamburg“ oder „Hauptstraße 123“. Der Dienst gibt eine Liste mit Orten zurück, die dem Textstring und ggf. der festgelegten Standortgewichtung entsprechen.

Die Textsuche (Legacy) ist nicht für mehrdeutige Suchanfragen vorgesehen, einschließlich der folgenden:

Abfragetyp	Beispiel
Zu viele Konzepte oder Einschränkungen, z. B. die Namen mehrerer Orte, Straßen oder Städte in einer einzelnen Abfrage	„Market Street San Francisco San Jose Airport“
Elemente der Postanschrift, die nicht in Google Maps dargestellt werden	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
Namen von Unternehmen, Ketten oder Kategorien in Kombination mit Standorten, an denen diese Unternehmen nicht verfügbar sind	„Tesco in der Nähe von Dallas, Texas“
Mehrdeutige Suchanfragen mit mehreren Interpretationen	„Ladegerät abgeben“
Nicht mehr verwendete historische Namen	"Middlesex United Kingdom"
Nicht-geospatial Elemente oder Absichten	„Wie viele Boote befinden sich im Ventura Harbor?“
Inoffizielle oder Vanity-Namen	„The Jenga“ „The Helter Skelter“
Geografische Koordinaten (Breiten- und Längengrad)	"37.422131,-122.084801"

Die Antwort der Suche enthält eine Liste mit Orten. Sie können eine „Place Details“-Anfrage senden, um weitere Informationen zu den zurückgegebenen Orten zu erhalten.

Text Search (Legacy)-Anfragen

Eine Text Search (Legacy)-Anfrage ist eine HTTP-URL im folgenden Format:

https://maps.googleapis.com/maps/api/place/textsearch/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.

Zum Initiieren einer Suchanfrage sind bestimmte Parameter erforderlich. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt.

Erforderliche Parameter

Abfrage

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 Betriebes oder Unternehmens sein. Alle anderen Arten von Eingaben führen vermutlich zu einem Fehler und die zurückgegebenen Ergebnisse sind möglicherweise ungültig. Der Google Places-Dienst gibt mögliche Übereinstimmungen basierend auf dem String zurück, die nach erkannter Relevanz sortiert werden.
Umkreis

Definiert die Entfernung (in Metern), innerhalb derer Ortsergebnisse zurückgegeben werden sollen. Wenn Sie die Parameter location und radius weitergeben, können Sie die Ergebnisse zugunsten eines festgelegten Kreises gewichten. Dadurch werden vom Places-Dienst vorzugsweise Ergebnisse für Orte angezeigt, die sich innerhalb dieses Kreises befinden. Ergebnisse außerhalb dieses Bereichs können aber trotzdem angezeigt werden.

Der Radius wird automatisch auf einen Höchstwert beschränkt, der vom Typ der Suche und anderen Parametern abhängt.
- Automatische Vervollständigung: 50.000 Meter
- Nearby Search:
  - mit keyword oder name: 50.000 Meter
  - ohne keyword oder name
    - Bis zu 50.000 Meter, dynamisch angepasst basierend auf der Gebietsdichte, unabhängig vom Parameter rankby.
    - Wenn Sie rankby=distance verwenden, wird der Radiusparameter nicht akzeptiert und es wird ein INVALID_REQUEST zurückgegeben.
- Query Autocomplete: 50.000 Meter
- Text Search: 50.000 Meter

Optionale Parameter

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“.
Standort

Der Punkt, um den herum Ortsinformationen abgerufen werden sollen. Dieser muss als latitude,longitude angegeben werden.

Der Parameter location kann überschrieben werden, wenn die query einen expliziten Ort wie Market in Barcelona enthält. Wenn Sie die Abfrage in Anführungszeichen setzen, kann dies auch die Gewichtung von location und radius beeinflussen.
maxprice

Damit werden die Ergebnisse auf Orte innerhalb des angegebenen Bereichs eingeschränkt. Werte von 0 (am preisgünstigsten) bis einschließlich 4 (am teuersten) sind zulässig. Der genaue Betrag, der durch einen bestimmten Wert angegeben wird, variiert von Region zu Region.
minprice

Damit werden die Ergebnisse auf Orte innerhalb des angegebenen Bereichs eingeschränkt. Werte von 0 (am preisgünstigsten) bis einschließlich 4 (am teuersten) sind zulässig. Der genaue Betrag, der durch einen bestimmten Wert angegeben wird, variiert von Region zu Region.
opennow

Es werden nur die Orte zurückgegeben, die beim Senden der Anfrage geöffnet haben. Wenn Sie diesen Parameter in Ihre Anfrage einbinden, werden keine Orte zurückgegeben, für die in der Google Places-Datenbank keine Öffnungszeiten hinterlegt sind.
pagetoken

Gibt bis zu 20 Ergebnisse einer zuvor ausgeführten Suche zurück. Wenn Sie einen pagetoken-Parameter festlegen, wird eine Suche mit denselben Parametern wie zuvor ausgeführt. Alle Parameter außer „pagetoken“ werden ignoriert.
Region

Der Regionscode, angegeben als zweistelliger Wert der Ländercode-Top-Level-Domain (ccTLD). Die meisten ccTLD-Codes entsprechen den ISO-3166-1-Codes. Es gibt jedoch einige Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO-3166-1-Code dagegen „gb“ (technisch gesehen für die Entität „Vereinigtes Königreich Großbritannien und Nordirland“).
Typ

Damit werden die Ergebnisse auf Orte beschränkt, die dem angegebenen Typ entsprechen. Es kann nur ein Typ angegeben werden. Werden mehrere Typen angegeben, wird nur der erste berücksichtigt.
- type=hospital|pharmacy|doctor wird zu type=hospital
- type=hospital,pharmacy,doctor wird vollständig ignoriert
Sehen Sie sich die Liste der unterstützten Typen an.

Hinweis: Wenn Sie sowohl keyword als auch type mit demselben Wert (keyword=cafe&type=cafe oder keyword=parking&type=parking) hinzufügen, kann dies zu ZERO_RESULTS führen.

Beispiele für Text Search (Legacy)

Hinweis:In diesen Beispielen müssen Sie key durch Ihren eigenen API-Schlüssel ersetzen, damit die Anfrage in Ihrer Anwendung funktioniert.

Einfaches Beispiel

Im folgenden Beispiel wird nach Restaurants in der Nähe von Sydney gesucht.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

Beispiel für unvollständige Adresse

Im folgenden Beispiel wird nach einer unvollständigen Adresse gesucht, in diesem Fall nach einer Adresse, die weder Stadt noch Bundesland oder Land enthält.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Beispiel für Standortverzerrung

Im folgenden Beispiel wird nach derselben unvollständigen Adresse wie im vorherigen Beispiel gesucht. Die Parameter location und radius werden verwendet, um die Ergebnisse auf eine bestimmte Region zu beschränken.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Text Search (Legacy)-Antworten

Suchantworten werden in dem Format zurückgegeben, das durch das Flag output im Pfad der URL-Anfrage angegeben ist.

Das folgende Beispiel zeigt eine Antwort für die Text Search (Legacy).

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

Feld	Erforderlich	Typ	Beschreibung
`html_attributions`	required	Array<string>	Kann eine Reihe von Quellenangaben zu diesem Eintrag enthalten, die dem Nutzer angezeigt werden müssen. Einige Einträge haben möglicherweise keine Quellenangabe.
`results`	required	Array<Place>	Enthält ein Array von Orten. Bei Place Search-Anfragen werden weniger Felder zurückgegeben als bei Place Details-Anfragen. 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 Orts-ID dann für eine „Place Details“-Anfrage verwenden. Weitere Informationen finden Sie unter Place.
`status`	required	PlacesSearchStatus	Enthält den Status der Anfrage und evtl. Debugging-Informationen, mit deren Hilfe Sie herausfinden können, warum die Anfrage zu Fehlern geführt hat. 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 `error_message`-Feld 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 das Antwortobjekt ein zusätzliches `info_messages`-Feld enthalten. Dieses Feld wird nur für erfolgreiche Anfragen zurückgegeben. Sie wird möglicherweise nicht immer zurückgegeben und ihr Inhalt kann sich ändern.
`next_page_token`	optional	String	Enthält ein Token, mit dem bis zu 20 zusätzliche Ergebnisse zurückgegeben werden können. Ein „next_page_token“ wird nicht zurückgegeben, wenn keine weiteren Ergebnisse angezeigt werden können. Es können maximal 60 Ergebnisse zurückgegeben werden. Zwischen der Ausgabe eines next_page_token und seiner Gültigkeit gibt es eine kurze Verzögerung.

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

Feld	Typ	Beschreibung
`business_status`	`string`	Gibt den Öffnungsstatus des Ortes an, sofern es sich um ein Unternehmen handelt: `OPERATIONAL`, `CLOSED_TEMPORARILY` oder `CLOSED_PERMANENTLY`. Wird weggelassen, wenn keine Statusdaten vorhanden sind.
`formatted_address`	`string`	Die menschenlesbare Adresse dieses Ortes. Wird von „Text Search (Legacy)“ und „Find Place (Legacy)“ zurückgegeben. Wir raten davon ab, die formatierte Adresse programmatisch zu parsen. Fordern Sie stattdessen `address_components` in Place Details (Legacy) an.
`geometry`	`Geometry`	Enthält die geocodierte `location` mit den Koordinaten `lat` und `lng` sowie die bevorzugte `viewport` mit den Grenzen `northeast` und `southwest`.
`icon`	`string`	Die URL eines vorgeschlagenen Symbols, das Sie anzeigen können, wenn Sie dieses Ergebnis auf einer Karte darstellen.
`icon_background_color`	`string`	Der standardmäßige Hexadezimal-Farbcode für die Kategorie des Orts.
`icon_mask_base_uri`	`string`	Die Basis-URL eines empfohlenen Symbols ohne die Dateityperweiterung „SVG“ oder „PNG“.
`name`	`string`	Der menschenlesbare Name für das zurückgegebene Ergebnis. Bei `establishment`-Ergebnissen ist dieser Wert normalerweise der kanonische Name des Unternehmens.
`opening_hours`	`PlaceOpeningHours`	Informationen zu den Öffnungszeiten. Place Search-Endpunkte geben nur das boolesche Unterfeld `open_now` zurück. Fordern Sie `opening_hours` in Place Details (Legacy) für `periods` und `weekday_text` an.
`permanently_closed`	`boolean`	Eingestellt:Verwenden Sie `business_status`, um den Öffnungsstatus eines Unternehmens zu prüfen.
`photos`	`Array<PlacePhoto>`	Ein Array von `PlacePhoto`-Objekten, die jeweils ein `photo_reference`, ein `height`, ein `width` und ein `html_attributions` enthalten. Weitere Informationen zur Verwendung finden Sie unter Place Photos (Legacy).
`place_id`	`string`	Eine ID in Textform, die einen Ort eindeutig bezeichnet. Übergeben Sie diese ID im Parameter `place_id` einer Place Details (Legacy)-Anfrage. Weitere Informationen finden Sie unter Orts-IDs.
`plus_code`	`PlusCode`	Ein codierter Verweis auf den Standort, der sich aus Breiten- und Längengrad ableiten lässt und einen `global_code` und optional einen `compound_code` enthält.
`price_level`	`integer`	Das Preisniveau des Ortes auf einer Skala von `0` bis `4`, von am günstigsten bis am teuersten. Siehe `price_level`.
`rating`	`number`	Die Bewertung des Ortes. Sie beruht auf aggregierten Nutzerrezensionen und liegt zwischen `1.0` und `5.0`.
`reference`	`string`	Nicht mehr unterstützt: Verwenden Sie stattdessen `place_id`.
`scope`	`string`	Verworfen: Gibt den Bereich des `place_id` an, der immer `GOOGLE` ist. Wird von Nearby Search (Legacy) zurückgegeben.
`types`	`Array<string>`	Ein Array von Elementtypen, die das jeweilige Ergebnis beschreiben. Weitere Informationen finden Sie unter Orts-Typen (alt).
`user_ratings_total`	`integer`	Die Gesamtzahl der Bewertungen für diesen Ort, mit oder ohne Rezensionstext.
`vicinity`	`string`	Eine vereinfachte Adresse des Ortes, einschließlich Straße, Hausnummer und Verwaltungseinheit, aber ohne Bundesland oder Provinz, Postleitzahl oder Land. Wird von Nearby Search (Legacy) zurückgegeben.

Weitere Ergebnisse aufrufen

Standardmäßig werden bei jeder Antwort bis zu 20 establishment-Ergebnisse pro Anfrage zurückgegeben. Für jede Suche können jedoch bis zu 60 Ergebnisse zurückgegeben werden, die auf drei Seiten angezeigt werden. Wenn Ihre Suche mehr als 20 Ergebnisse zurückgibt, enthält die Suchantwort einen zusätzlichen Wert: next_page_token. Übergeben Sie den Wert von next_page_token an den Parameter pagetoken einer neuen Anfrage, um die nächste Gruppe von Ergebnissen zu sehen.

Wenn next_page_token null ist oder nicht zurückgegeben wird, gibt es keine weiteren Ergebnisse.
Wenn Sie die Anfrage mit demselben next_page_token wiederholen, wird die nächste Ergebnisseite zurückgegeben.
Wenn Sie pagetoken festlegen, werden alle anderen Parameter ignoriert.
Nach der ursprünglichen Anfrage kannst du bis zu zweimal eine neue Seite anfordern.
Jede Anfrage, einschließlich einer Anfrage mit next_page_token, wird als einzelne Anfrage auf Ihre Nutzungslimits angerechnet und separat in Rechnung gestellt.
Zwischen der Ausstellung eines next_page_token und dem Zeitpunkt, an dem es gültig wird, gibt es eine Verzögerung von einigen Sekunden. Wenn Sie die nächste Seite anfordern, bevor sie verfügbar ist, wird die Antwort INVALID_REQUEST zurückgegeben. Anfragen mit next_page_token werden immer in Rechnung gestellt.
Hinweis: Die korrekte Verwendung von next_page_token besteht darin, die nächste Ergebnisseite nur dann anzufordern, wenn der Nutzer dies wünscht. Wir empfehlen, entweder echtes Paging zu implementieren (jeweils 20 Ergebnisse anzeigen) oder zusätzliche Orte am Ende einer Ergebnisseite anzuhängen, sobald der Nutzer zum Ende scrollt.

In der folgenden Abfrage suchen wir beispielsweise nach Restaurants in der Nähe von Darling Harbour in Sydney, Australien, und sortieren die Ergebnisse nach Entfernung. Die Antwort enthält das Attribut next_page_token.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

Wenn Sie die nächsten Ergebnisse sehen möchten, können Sie eine neue Abfrage senden und das Ergebnis von next_page_token an den Parameter pagetoken übergeben. Beispiel:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

Text Search (Legacy) Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Text Search (Legacy)-Anfragen

Erforderliche Parameter

Abfrage

Umkreis

Optionale Parameter

Sprache

Standort

maxprice

minprice

opennow

pagetoken

Region

Typ

Beispiele für Text Search (Legacy)

Einfaches Beispiel

curl

HTTP

Beispiel für unvollständige Adresse

curl

HTTP

JSON

XML

Beispiel für Standortverzerrung

curl

HTTP

JSON

XML

Text Search (Legacy)-Antworten

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

Ort

Weitere Ergebnisse aufrufen

Text Search (Legacy)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`