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

beim lokalen Entdecken.

Bei der lokalen Suche nach einem Hotel oder einer Immobilie werden Nutzern wichtige POIs in der Nähe des Standorts angezeigt, den Sie angeben. Sie besteht oft aus einer interaktiven Karte mit einem zusätzlichen Bereich mit einer Ortsauswahl und einer Fotogalerie. Sie lernen verschiedene Google Maps Platform-Produkte und ‐Funktionen kennen, mit denen Sie das Erlebnis durch Interaktivität verbessern können.

Anwendungsbereiche

Sehen wir uns nun an, welche Elemente der lokalen Discovery-Integration den Nutzerwert steigern:

• Auffindbarkeit – Nutzern einen Überblick über die Umgebung eines einzelnen Standorts geben, indem relevante Orte verschiedener Art angezeigt werden

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

  bezogen auf diesen Ort.

• Visualisierung – Rezensionen und Fotos zu Orten veröffentlichen

  Gehzeit und Entfernung, anhand derer die Nutzenden schnell erkennen können, ob es ihren Anforderungen entspricht.

Referenzarchitektur

Lokale Suche

Es gibt viele Möglichkeiten, wie sich lokale Suchanfragen anbieten können. Die folgende Integration ist ein benutzerdefiniertes Beispiel für eine Nutzererfahrung, die bekannte Google Maps Platform APIs sowie einige spannende neue Funktionen nutzt. Wenn Sie einen vorlagenbasierten Ansatz 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 in Schritte unterteilte Beispielanwendung sowie eine Beschreibung der technischen Implementierung mit den Google Maps Platform-APIs.

1. Standortsuche mit AutocompleteSearch-Standort

• Laden Sie die Maps JavaScript API.
• Places Autocomplete-Anfrage stellen oder einen Standort auf der Karte auswählen

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 passende Typen einschließen, z. B. „Restaurant, Café, Park, Tourit_attraction“.
• 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; bei NULL Ergebnissen müssen Sie die Größe des Kreises / Rechtecks erweitern, bevor Sie Ergebnisse anzeigen.

Beispiel für eine Hotelbuchung 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 die 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. Interaktivität mit Dynamic Maps und Directions API hinzufügen

• Strecke und Schritte durch Abfragen der Directions API auf dem neuesten Stand halten * Verwenden Sie die Zeit im nächsten Abschnitt.

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 Vorschau der Nearby Search (New) API müssen Sie Places Details mit place.id abfragen, um photo_reference abzurufen und dann nacheinander eine Abfrage auszuführen.

Anzahl der Abfragen und zugehörige Kosten

• Maps JavaScript API: 1 Karte beim Laden des Tests.
• Places Autocomplete API: 1 Abfrage für jedes eingegebene Zeichen (bei Verwendung des Autocomplete-Widgets) kann angepasst werden.
• Nearby Search (New) API: 1 Abfrage alle 20 angezeigten Orte. Unterschiedliche Abrechnungen gemäß den Place-Daten, die Teil der Abfrageantwort sind.
• Directions API: Hier wird jeder vom Nutzer ausgewählte Ort mit einer Suchanfrage abgefragt.
• Place Photo API: Alle angezeigten Fotos werden abgefragt.

Fazit

Eine lokale Suche auf Google ist eine hervorragende Möglichkeit, Nutzern einen Mehrwert zu bieten. Diese Demoimplementierung bietet viele Funktionen, die Sie wahrscheinlich einbinden werden, wenn Sie ein solches Erlebnis auf der Google Maps Platform mit speziellen Funktionen der Nearby Search (New) API erstellen.

Nächste Schritte

Leseempfehlungen:

• Webkomponenten in der Maps JavaScript API
• „Place Autocomplete“-Optimierung
• Andere Places-Dienste
• Geben Sie unten Feedback.

Beitragende

Hauptautoren:

Thomas Anglaret | Google Maps Platform Solutions Engineer