Mit der Nearby Search API die lokale Auffindbarkeit verbessern (New) API

In diesem Dokument erfahren Sie, wie Sie mit der Nearby Search (New) API eine einfache und kostengünstige

lokale Suche.

Bei der lokalen Suche werden Nutzern wichtige POIs in der Nähe eines von Ihnen angegebenen Standorts angezeigt, wenn sie nach einem Hotel oder einer Immobilie suchen. Sie besteht oft aus einer interaktiven Karte mit einem zusätzlichen Bereich, der eine Ortsauswahl und eine Fotogalerie enthält. Sie sehen verschiedene Google Maps Platform-Produkte und -Funktionen, mit denen Sie die Interaktivität verbessern können.

Beispiel für die lokale Suche

Anwendungsfälle

Sehen wir uns nun an, welche Elemente der Integration für die lokale Erkennung den Nutzerwert steigern:

  • Explore (Entdeckung): Sie können Nutzern eine Übersicht über die Umgebung eines bestimmten Orts geben, indem Sie relevante Orte verschiedener Typen anzeigen.

  • Interaktivität: Nutzer können einen Ort auswählen und die Daten dynamisch aktualisieren

    die sich auf diesen Ort beziehen.

  • Visualisierung – Stellen Sie Rezensionen und Fotos zu Orten zur Verfügung.

    sowie die Gehzeit und -entfernung, damit die Nutzer schnell erkennen, ob sie ihren Anforderungen entsprechen.

Referenzarchitektur

alt_text

Lokale Suche

Es gibt viele Möglichkeiten, lokale Entdeckungen zu ermöglichen. Die folgende Integration ist ein benutzerdefiniertes Beispiel für eine Nutzererfahrung, bei der bekannte Google Maps Platform APIs sowie einige interessante neue Funktionen zum Einsatz kommen. Wenn Sie eine Vorlage für die lokale Erkennung verwenden möchten, können Sie Webkomponenten verwenden.

Beispiel-App

Beispielhafte Schritt-für-Schritt-Anleitung

In der folgenden Tabelle finden Sie die Beispielanwendung in einzelnen Schritten sowie eine Beschreibung der technischen Implementierung mit den APIs der Google Maps Platform.

1. Standortsuche mit automatischer Vervollständigung von Standortinformationen

  • Laden Sie die Maps JavaScript API.
  • Führen Sie eine Place Autocomplete-Suchanfrage aus oder wählen Sie einen Ort auf der Karte aus.

Beispiel für automatische Vervollständigung

2. Lokale POIs mit der Nearby Search (New) API anzeigen

  • Beliebtheitsrangfolge (relevantere Ergebnisse) oder Entfernungsrangfolge
  • includedTypes, excludedTypes: Wenn Sie ein Hotel sind, können Sie den Typ „Unterkunft“ ausschließen und nur geeignete Typen angeben, z. B. „Restaurant“, „Café“, „Park“ oder „tourist_attraction“.
  • Nutzen Sie includedPrimaryTypes und excludedPrimaryTypes für noch mehr Kontrolle über die Ergebnisse.
  • „locationRestriction“, um eine unzureichende Anzahl von Ergebnissen oder Orte, die zu weit entfernt sind, zu vermeiden; bei NULL Ergebnissen den Kreis / das Rechteck vergrößern, bevor Ergebnisse angezeigt werden.

Beispiel für Orte in der Nähe

Beispiel für eine Abfrage bei der Buchung eines Hotels mit angeforderten Datenfeldern:

  • Einfach (displayName, types, openingHours, formattedAddress)
  • Kontakt (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Bevorzugt (reviews, priceLevel, userRatingCount)
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

Beispiel für eine Abfrage bei der Suche nach einer Immobilie mit angeforderten Datenfeldern:

  • Einfach (displayName, types, openingHours, formattedAddress)
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Mit der Dynamic Maps and Directions API Interaktivität hinzufügen

  • Aktuelle Abschnitte und Schritte durch Abfragen der Wegbeschreibungs-API * Verwenden Sie im nächsten Abschnitt die Zeit.

Beispiel für eine Wegbeschreibung

4. Detaillierte Informationen zum Ort bei Interaktion anzeigen

  1. Beschreibung: displayName, types, rating, userRatingCount, priceLevel.

    Zeit: stammt aus der vorherigen Directions API-Abfrage.

  2. Rezensionen: reviews[i].author, reviews[i].rating,reviews[i].text.

  3. Bilder: Während der uneingeschränkten Vorabversion der Nearby Search API (neu) müssen Sie Places Details mit place.id abfragen, um photo_reference zu erhalten, und dann einzeln in Ihrer Anwendung abfragen.

Orte – Details

Anzahl der Abfragen und zugehörige Kosten

Fazit

Eine Funktion zur lokalen Suche ist eine wirkungsvolle Möglichkeit, Nutzern einen Mehrwert zu bieten. Diese Demonstrationsumsetzung enthält viele Funktionen, die Sie wahrscheinlich verwenden, wenn Sie eine solche Funktion in der Google Maps Platform mit speziellen Funktionen der Nearby Search (New) API erstellen.

Nächste Schritte

Empfohlene weiterführende Informationen:

Beitragende

Hauptautoren:

Thomas Anglaret | Google Maps Platform Solutions Engineer