In diesem Dokument erfahren Sie, wie Sie Nearby Search (New) API einfache und kostengünstige
lokale Suche
Bei der lokalen Suche sehen Nutzer wichtige POIs in der Nähe eines Standorts die Sie bei der Suche nach einem Hotel oder einer Immobilie angeben. Sie besteht oft aus einer interaktiven Karte mit einem zusätzlichen Bereich, der eine Ortsauswahl und eine Fotogalerie enthält. Ihnen werden verschiedene Google Maps Platform-Funktionen präsentiert. Produkten und Funktionen, um das Erlebnis durch Interaktivität zu verbessern.
Anwendungsfälle
Sehen wir uns nun an, welche Elemente der Einbindung in lokale Suchergebnisse den Mehrwert für Nutzer steigern:
Auffindbarkeit – Nutzern einen Überblick über die Umgebung eines einzelnen Standorts geben indem relevante Orte verschiedenster Art angezeigt werden.
Interaktivität – Bieten Sie Nutzern die Möglichkeit, einen Ort auszuwählen und die Daten dynamisch zu aktualisieren.
die sich auf diesen Ort beziehen.
Visualisierung – Stellen Sie Rezensionen und Fotos zu Orten zur Verfügung.
sowie die Gehzeit und Entfernung, damit die Nutzenden schnell erkennen, ihre Bedürfnisse zu erfüllen.
Referenzarchitektur
Lokale Suche
Es gibt viele Möglichkeiten, lokale Empfehlungen zu schaffen. Die folgenden ist die Integration ein benutzerdefiniertes Beispiel für eine User Experience, die bekannten Google Maps Platform-APIs sowie einige interessante neue Funktionen. Wenn Sie wünschen sich einen vorlagenbasierten Ansatz für die lokale Suche. Sie können dazu Web- Komponenten.
Beispiel-App
Beispielhafte Schritt-für-Schritt-Anleitung
Die Beispielanwendung wird in der Tabelle unter den einzelnen Schritten dargestellt. zusammen mit einer Beschreibung der technischen Umsetzung mit Google Maps. Plattform-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
; Wenn Sie ein Hotel sind, können Sie "Unterkünfte" und schließen Sie nur geeignete Kategorien ein, 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 Orte, die zu weit entfernt sind, zu vermeiden; bei NULL Ergebnissen den Kreis/das Rechteck vergrößern, bevor Ergebnisse angezeigt werden.
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 von Directions API verfügbar. * Nutzen Sie die Zeit im nächsten Abschnitt.
4. Bei der Interaktion detaillierte Informationen zum Ort anzeigen
Beschreibung:
displayName
,types
,rating
,userRatingCount
,priceLevel
Zeit: kommt von 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 wird Folgendes angezeigt: müssen Places Details mit
place.id
, um photo_reference und dann eine nach der anderen abfragen,
Anzahl der Abfragen und zugehörige Kosten
- Maps-JavaScript API: 1 Karte beim Laden der Erfahrung.
- Places Autocomplete API: 1 Suchanfrage pro eingegebenem Zeichen (bei Verwendung des Automatische Vervollständigung Widget) kann angepasst werden.
- Nearby Search (neu) API: 1 Suchanfrage alle 20 angezeigten Orte. Abweichende Abrechnung nach Place Daten die Teil der Abfrageantwort sind.
- Google Maps API: 1 Abfrage pro vom Nutzer ausgewählten Ort.
- Ortsfoto API: 1 Suchanfrage für jedes angezeigte Foto.
Fazit
Ein lokales Erlebnis ist ein wirkungsvolles Mittel, um Nutzern einen Mehrwert zu bieten. Dieses Demo-Implementierung enthält viele Funktionen, die Sie wahrscheinlich die auf der Google Maps Platform ein solches Erlebnis mit besonderen Funktionen aus der Nearby Search (New) API
Nächste Schritte
Weitere Informationen:
- Web Components in der Maps JavaScript API
- Place Autocomplete-Optimierung
- Andere Places-Dienste
- Du kannst uns unten Feedback geben.
Beitragende
Hauptautoren:
Thomas Anglaret | Google Maps Platform Solutions Engineer