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

Local Discovery Experience.

Bei der lokalen Suche sehen Nutzer wichtige POIs in der Nähe eines Standorts, den Sie bei der Suche nach einem Hotel oder einer Immobilie angeben. Sie besteht häufig aus einer interaktiven Karte mit einem zusätzlichen Bereich mit einer Ortsauswahl und einer Fotogalerie. Ihnen werden verschiedene Google Maps Platform-Produkte und -Funktionen vorgestellt, die die Interaktion mit der Plattform verbessern.

Anwendungsbereiche

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

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

• Interaktivität – Bieten Sie Nutzern die Möglichkeit, einen Ort auszuwählen und die Daten dynamisch zu aktualisieren.

  in Bezug auf diesen Ort.

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

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

Referenzarchitektur

Lokale Suche

Es gibt viele Möglichkeiten, lokale Empfehlungen zu schaffen. 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 Tabelle unten finden Sie die Beispielanwendung, die in einzelne Schritte unterteilt ist, zusammen mit einer Beschreibung der technischen Implementierung mit den Google Maps Platform APIs.

1. Standortsuche mit automatischer Vervollständigung von Standortinformationen

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

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

• Beliebtheitsrangfolge (relevantere Ergebnisse) oder Entfernungsrang
• includedTypes, excludedTypes. Als Hotel können Sie den Typ „Unterkunft“ ausschließen und nur bestimmte Typen einschließen, z. B. „Restaurant, Café, Park, Tourit-Attraktion“.
• Nutzen Sie includedPrimaryTypes und excludedPrimaryTypes für noch mehr Kontrolle über die Ergebnisse.
• `locationRestriction , um eine unzureichende Anzahl von Ergebnissen oder zu weit entfernte Orte zu vermeiden. Erweitern Sie bei NULL-Ergebnissen den Kreis / Rechteck, bevor Sie die Ergebnisse anzeigen.

Abfragebeispiel 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 } } }

Abfragebeispiel für die Suche in 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

• Aktuelle Abschnitte und Schritte durch Abfrage der Directions API. * Nutzen Sie die Zeit im nächsten Abschnitt.

4. Bei der Interaktion detaillierte Informationen zum Ort anzeigen

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

   Zeit: kommt von 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 nacheinander Abfragen durchzuführen

Anzahl der Abfragen und zugehörige Kosten

• Maps JavaScript API: 1 Karte beim Laden der Websitevariante.
• 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 Abrechnung je nach Place-Daten, die Teil der Abfrageantwort sind.
• Directions API: Eine Abfrage für jeden vom Nutzer ausgewählten Ort
• Place Photo API: Eine Abfrage für jedes angezeigte Foto.

Fazit

Ein lokales Erlebnis ist ein wirkungsvolles Mittel, um Nutzern einen Mehrwert zu bieten. Diese Demonstrationsimplementierung enthält viele Funktionen, die Sie wahrscheinlich nutzen werden, wenn Sie ein solches Angebot auf der Google Maps Platform mit speziellen Funktionen aus der Nearby Search (New) API erstellen.

Nächste Schritte

Weitere Informationen:

• Webkomponenten in der Maps JavaScript API
• Places Autocomplete-Optimierung
• Andere Places-Dienste
• Du kannst uns unten Feedback geben.

Beitragende

Hauptautoren:

Thomas Anglaret | Google Maps Platform Solutions Engineer