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
undexcludedPrimaryTypes
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
Beschreibung:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Zeit: stammt aus der vorherigen Directions API-Abfrage.
Rezensionen:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.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