In diesem Dokument erfahren Sie, wie Sie Nearby Search (New) API einfache und kostengünstige
Local Discovery Experience.
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 häufig aus einer interaktive Karte mit einem zusätzlichen Bereich, der eine Ortsauswahl und einen Fotogalerie. 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 Local Discovery Integration Wert:
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.
in Bezug auf diesen Ort.
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 bekannte Google Maps Platform-APIs sowie einige spannende 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.- Nutzen Sie
includedPrimaryTypes
undexcludedPrimaryTypes
für noch mehr Kontrolle über die Ergebnisse. - „locationRestriction“, um eine unzureichende Anzahl von Ergebnissen oder zu weit entfernte Ergebnisse zu vermeiden Places : Bei NULL-Ergebnissen die Kreis-/Rechteckgröße zuerst erweitern um Ergebnisse anzuzeigen.
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
- Aktuelles Abschnitt 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.
- Wegbeschreibung API: 1 Suchanfrage für jeden 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:
- 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