In diesem Dokument erfahren Sie, wie Sie mit der Nearby Search (New) API eine einfache und kostengünstige
lokale Suche.
Mit der Funktion „Lokale Entdeckungen“ werden Nutzern wichtige POIs in der Nähe eines von Ihnen angegebenen Ortes angezeigt, wenn sie nach einem Hotel oder einer Immobilie suchen. Sie besteht häufig aus einer interaktiven Karte mit einem zusätzlichen Bereich, der eine Ortsauswahl und eine Fotogalerie enthält. Ihnen werden verschiedene Google Maps Platform-Produkte und ‑Funktionen vorgestellt, mit denen Sie die Interaktivität verbessern können.

Anwendungsfälle
Sehen wir uns nun an, welche Elemente der Integration der lokalen Suche für Nutzer von Vorteil sind:
Entdecken: Nutzer erhalten einen Überblick über die Umgebung eines einzelnen Standorts, indem relevante Orte verschiedener Typen angezeigt werden.
Interaktivität: Nutzer können einen Ort auswählen und die Daten dynamisch aktualisieren.
relativ zu diesem Ort.
Visualisierung – Rezensionen und Fotos zu Orten bereitstellen
und die Gehzeit und -strecke, damit Nutzer schnell erkennen können, ob die Route ihren Anforderungen entspricht.
Referenzarchitektur

Lokale Suche
Es gibt viele Möglichkeiten, eine lokale Entdeckung zu ermöglichen. Die folgende Integration ist ein benutzerdefiniertes Beispiel für eine Nutzererfahrung, bei der bekannte Google Maps Platform APIs sowie einige interessante neue Funktionen verwendet werden. 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 Beispielanwendung in einzelne Schritte unterteilt, zusammen mit einer Beschreibung der technischen Implementierung mit Google Maps Platform APIs.
1. Standortsuche mit automatischer VervollständigungStandort suchen
- Laden Sie die Maps JavaScript API.
- Place Autocomplete-Abfrage oder Auswahl eines Standorts auf der Karte.

2. Mit der Nearby Search (New) API können Sie lokale POIs anzeigen lassen.
- Beliebtheitsranking (relevantere Ergebnisse) oder Entfernungsranking.
includedTypes,excludedTypes; wenn Sie ein Hotel sind, können Sie den Typ „lodging“ ausschließen und nur geeignete Typen wie „restaurant, cafe, park, tourist_attraction“ einschließen.- Nutzen Sie
includedPrimaryTypesundexcludedPrimaryTypes, um noch mehr Kontrolle über die Ergebnisse zu haben. - `locationRestriction`, um eine unzureichende Anzahl von Ergebnissen oder zu weit entfernte Orte zu vermeiden. Wenn keine Ergebnisse zurückgegeben werden, vergrößern Sie den Kreis oder das Rechteck, bevor Sie die Ergebnisse anzeigen.

Beispielabfrage beim Buchen eines Hotels mit angeforderten Datenfeldern:
- Basic (
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 } } }Beispielabfrage für die Suche nach einer Immobilie mit angeforderten Datenfeldern:
- Basic (
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 der Directions API hinzufügen
- Aktuelle Abschnitte und Schritte durch Abfragen der Directions API. * 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 Vorabversion der Nearby Search (New) API müssen Sie Place Details mit
place.idabfragen, um photo_reference zu erhalten. Diese können Sie dann einzeln in Ihrer Anwendung abfragen.

Anzahl der Abfragen und damit verbundene Kosten
- Maps JavaScript API: 1 Karte beim Laden der Anwendung.
- Places Autocomplete API: 1 Abfrage pro eingegebenem Zeichen (bei Verwendung des Autocomplete-Widgets). Dies kann angepasst werden.
- Nearby Search (New) API: 1 Abfrage pro 20 angezeigte Orte. Unterschiedliche Abrechnung je nach Ortsdaten, die Teil der Abfrageantwort sind.
- Directions API: 1 Abfrage pro vom Nutzer ausgewähltem Ort.
- Place Photo API: 1 Abfrage pro angezeigtem Foto.
Fazit
Eine lokale Suchfunktion ist eine gute Möglichkeit, Nutzern einen Mehrwert zu bieten. Diese Demo-Implementierung enthält viele Funktionen, die Sie wahrscheinlich einbinden werden, wenn Sie eine solche Anwendung auf der Google Maps Platform mit speziellen Funktionen der Nearby Search (New) API erstellen.
Nächste Schritte
Empfohlene weitere Informationen:
- Web Components in der Maps JavaScript API
- Places Autocomplete-Optimierung
- Andere Places-Dienste
- Hinterlassen Sie unten Feedback.
Beitragende
Hauptautoren:
Thomas Anglaret | Google Maps Platform Solutions Engineer