Nearby Search (Legacy)

Mit der Nearby Search (Legacy) können Sie nach Orten innerhalb eines bestimmten Bereichs suchen. Sie können Ihre Suchanfrage verfeinern, indem Sie Suchbegriffe angeben oder den Typ des gesuchten Ortes festlegen.

„Nearby Search (Legacy)“-Anfragen

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

https://maps.googleapis.com/maps/api/place/nearbysearch/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 Nearby Search (Legacy)-Anfrage sind bestimmte Parameter erforderlich. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt.

Erforderliche Parameter

• Standort

  Der Punkt, um den herum Ortsinformationen abgerufen werden sollen. Dieser muss als latitude,longitude angegeben 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

• Keyword

  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. Über den Google Places-Dienst werden mögliche Übereinstimmungen basierend auf dem String zurückgegeben, die nach erkannter Relevanz sortiert werden.

  Wenn Sie Standortinformationen explizit mit diesem Parameter angeben, kann dies zu Konflikten mit den Parametern „location“, „radius“ und „rankby“ führen und unerwartete Ergebnisse verursachen.

  Wenn dieser Parameter weggelassen wird, werden Orte mit dem business_status CLOSED_TEMPORARILY oder CLOSED_PERMANENTLY nicht zurückgegeben.

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

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

• name

  Gleichbedeutend mit keyword. Die Werte in diesem Feld werden mit den Werten im Feld keyword kombiniert und als Teil desselben Suchstrings übergeben.

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

• rankby

  Gibt die Reihenfolge an, in der die Ergebnisse aufgelistet werden. Folgende Werte sind möglich:

  • prominence (Standard): Mit dieser Option werden die Ergebnisse nach ihrer Wichtigkeit sortiert. In der Liste werden relevante Orte innerhalb des eingestellten Radius gegenüber Orten in der Nähe bevorzugt, die übereinstimmen, aber weniger relevant sind. Die Relevanz kann durch die Bewertung eines Ortes im Index von Google, die weltweite Bekanntheit und weitere Faktoren beeinflusst werden. Wenn „prominence“ angegeben ist, ist der Parameter radius erforderlich.
  • distance. Bei dieser Option werden die Suchergebnisse in aufsteigender Reihenfolge nach ihrer Entfernung vom angegebenen Ort sortiert. Wenn distance angegeben ist, ist mindestens einer der Werte keyword, name oder type erforderlich und radius ist nicht zulässig.

• Typ

  Damit werden die Ergebnisse auf Orte beschränkt, die dem angegebenen Typ entsprechen. Sie können nur einen Typ angeben. Wenn Sie mehr als einen Typ angeben, ignoriert die API alle Typen nach dem ersten Eintrag.

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

Beispiel für Nearby Search (Legacy)

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

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

Nearby Search (Legacy)-Antworten

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

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}
    

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</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/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
</PlaceSearchResponse>

    

PlacesNearbySearchResponse

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

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.

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