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

Funktion für die lokale Suche erstellen.

Bei der lokalen Suche werden Nutzern wichtige POIs in der Nähe eines von Ihnen angegebenen Ortes 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 erhalten Informationen zu verschiedenen Google Maps Platform-Produkten und -Funktionen, mit denen Sie die Nutzererfahrung durch Interaktivität verbessern können.

Beispiel für die lokale Suche

Anwendungsfälle

Sehen wir uns nun an, welche Elemente der lokalen Suche für Nutzer von Vorteil sind:

  • Suche : Geben Sie Nutzern einen Überblick über die Umgebung eines bestimmten Ortes, indem Sie relevante Orte verschiedener Typen präsentieren.

  • Interaktivität : Ermöglichen Sie Nutzern, einen Ort auszuwählen und die Daten dynamisch zu aktualisieren,

    die sich auf diesen Ort beziehen.

  • Visualisierung : Stellen Sie Rezensionen, Fotos

    sowie die Gehzeit und Entfernung zu Orten bereit, damit Nutzer schnell sehen können, ob sie ihren Anforderungen entsprechen.

Referenzarchitektur

alt_text

Lokale Suche

Es gibt viele Möglichkeiten, eine Funktion für die lokale Suche zu erstellen. Die folgende Integration ist ein benutzerdefiniertes Beispiel für eine Nutzererfahrung, bei der bekannte Google Maps Platform APIs sowie einige neue Funktionen genutzt werden. Wenn Sie einen vorlagenbasierten Ansatz für die lokale Suche bevorzugen, können Sie Web Componentsverwenden.

Beispiel-App

Beispielhafte Schritt-für-Schritt-Anleitung

In der folgenden Tabelle finden Sie die Beispiel-App in einzelne Schritte unterteilt sowie eine Beschreibung der technischen Implementierung mit Google Maps Platform APIs.

1. Ortssuche mit automatischer VervollständigungOrt suchen

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

automatische Vervollständigung von Beispielen

2. Lokale POIs mit der Nearby Search (New) API präsentieren

  • Ranking nach Beliebtheit (relevantere Ergebnisse) oder Entfernung.
  • includedTypes, excludedTypes: Wenn Sie ein Hotel betreiben, können Sie den Typ „Unterkunft“ ausschließen und nur geeignete Typen einbeziehen, z. B. „Restaurant, Café, Park, Touristenattraktion“.
  • Mit includedPrimaryTypes und excludedPrimaryTypes haben Sie noch mehr Kontrolle über die Ergebnisse.
  • `locationRestriction`, um eine unzureichende Anzahl von Ergebnissen oder zu weit entfernte Orte zu vermeiden. Wenn keine Ergebnisse vorhanden sind, vergrößern Sie den Kreis oder das Rechteck, bevor Sie die Ergebnisse anzeigen.

Beispiel für Orte in der Nähe

Beispiel für eine Abfrage beim Buchen eines Hotels mit den angeforderten Datenfeldern:

  • Basic (displayName, types, openingHours, formattedAddress)
  • Contact (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferred (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 den angeforderten Datenfeldern:

  • Basic (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 dynamischen Karten und der Directions API Interaktivität hinzufügen

  • Aktuelle Etappen und Schritte durch Abfragen der Directions API. * Verwenden Sie die Zeit im nächsten Abschnitt.

Beispielanleitung

4. Bei Interaktion detaillierte Informationen zum Ort anzeigen

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

    Zeit: aus der vorherigen Directions API-Abfrage.

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

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

Details zu Orten

Anzahl der Abfragen und zugehörige Kosten

Fazit

Eine Funktion für die lokale Suche ist eine effektive Möglichkeit, Nutzern einen Mehrwert zu bieten. Diese Beispielimplementierung enthält viele Funktionen, die Sie wahrscheinlich verwenden werden, wenn Sie eine solche Funktion in der Google Maps Platform erstellen, mit speziellen Funktionen der Nearby Search (New) API .

Nächste Schritte

Empfohlene Artikel:

Beitragende

Hauptautoren:

Thomas Anglaret | Google Maps Platform Solutions Engineer