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 Einbindung in lokale Suchergebnisse den Mehrwert für Nutzer 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

    relativ zu diesem Ort.

  • Visualisierung – Rezensionen und Fotos zu Orten bereitstellen

    und die Gehzeit und -entfernung, damit Nutzer schnell erkennen können, ob sie zu ihren Anforderungen passt.

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 User Experience, bei der bekannte Google Maps Platform APIs sowie einige spannende neue Funktionen genutzt werden. Wenn Sie einen vordefinierten Ansatz für lokale Suchanzeigen verwenden möchten, können Sie Webkomponenten verwenden.

Beispiel-App

Beispiel für eine Schritt-für-Schritt-Anleitung

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

1. Standortsuche mit automatischer Vervollständigung

  • 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 die 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 „touristische_attraktion“.
  • Mit includedPrimaryTypes und excludedPrimaryTypes haben Sie 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