Mit der Nearby Search API die lokale Auffindbarkeit verbessern (New) API
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument erfahren Sie, wie Sie die Nearby Search (New) API
verwenden, um eine einfache und kostengünstige
lokale Discovery-Oberfläche.
Bei der lokalen Suche 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 oft aus einer interaktiven Karte mit einem zusätzlichen Bereich, der eine Ortsauswahl und eine Fotogalerie enthält. Sie sehen verschiedene Google Maps Platform-Produkte und ‑Funktionen, mit denen Sie die Interaktivität verbessern können.
Anwendungsfälle
Sehen wir uns nun an, welche Elemente der Integration für die lokale Suche den Nutzerwert steigern:
Entdeckung: Nutzer erhalten einen Überblick über die Umgebung eines bestimmten Orts, indem relevante Orte verschiedener Art angezeigt werden.
Interaktivität: Nutzer können einen Ort auswählen und die Daten dynamisch aktualisieren.
relativ zu diesem Ort.
Visualisierung – Rezensionen und Fotos für Orte bereitstellen
und Gehzeit und ‑strecke, damit die Nutzer schnell sehen, ob die Route ihren Anforderungen entspricht.
Referenzarchitektur
Lokale Suche
Es gibt viele Möglichkeiten, die lokale Auffindbarkeit zu verbessern. Die folgende Integration ist ein benutzerdefiniertes Beispiel für eine Benutzeroberfläche, die bekannte Google Maps Platform APIs sowie einige interessante neue Funktionen nutzt. Wenn Sie einen auf Vorlagen basierenden Ansatz für die lokale Suche verwenden möchten, können Sie Web-Komponenten verwenden.
Beispiel-App
Beispielhafte Schritt-für-Schritt-Anleitung
In der folgenden Tabelle finden Sie die Beispielanwendung in einzelne Schritte unterteilt sowie eine Beschreibung der technischen Implementierung mit Google Maps Platform-APIs.
1. Standortsuche mit automatischer VervollständigungStandort suchen
- Laden Sie die Maps JavaScript API.
- Places Autocomplete-Abfrage oder Auswahl eines Orts auf der Karte.
- Rangfolge nach Beliebtheit (relevantere Ergebnisse) oder nach Entfernung.
includedTypes, excludedTypes – wenn Sie ein Hotel sind, können Sie den Typ „Unterkunft“ ausschließen und nur geeignete Typen einbeziehen, z. B. „Restaurant, Café, Park, Touristenattraktion“.- Nutzen Sie
includedPrimaryTypes und excludedPrimaryTypes, um noch mehr Kontrolle über die Ergebnisse zu haben.
- `locationRestriction, um eine unzureichende Anzahl von Ergebnissen oder zu weit entfernte Orte zu vermeiden; bei KEINEN Ergebnissen die Kreis-/Rechteckgröße vor der Anzeige der Ergebnisse vergrößern.
Beispiel für eine Anfrage beim Buchen 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 } } }
Beispiel für eine Anfrage beim Suchen 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 der Dynamic Maps API und der Directions API hinzufügen
- Aktuelle Etappen und Schritte durch Abfragen der Directions API.
* Verwenden Sie die Zeit im nächsten Abschnitt.
Beschreibung: displayName, types, rating, userRatingCount,
priceLevel.
Zeit: stammt aus der vorherigen Directions API-Anfrage.
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 Places Details mit place.id abfragen, um photo_reference zu erhalten, die Sie dann einzeln in Ihrer Anwendung abfragen können.
Anzahl der Abfragen und zugehörige Kosten
Fazit
Die lokale Suche ist eine effektive Möglichkeit, Nutzern einen Mehrwert zu bieten. Diese Demonstrationsimplementierung 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 Artikel:
Beitragende
Hauptautoren:
Thomas Anglaret | Google Maps
Platform Solutions Engineer
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-27 (UTC)."],[[["\u003cp\u003eThis document demonstrates how to build a local discovery experience using the Nearby Search (New) API, enhancing user engagement with interactive maps and relevant place recommendations.\u003c/p\u003e\n"],["\u003cp\u003eLocal discovery experiences benefit users by offering discovery of nearby points of interest, interactive place selection and dynamic data refresh, and visualizations with reviews, photos, and travel times.\u003c/p\u003e\n"],["\u003cp\u003eThis guide presents a custom local discovery implementation leveraging Google Maps Platform APIs including Nearby Search (New) API, Places Autocomplete, Directions API, and Place Photo API for detailed place information.\u003c/p\u003e\n"],["\u003cp\u003eThe example application showcases the process of location search using Autocomplete, retrieving local points of interest with Nearby Search (New) API, adding interactivity with Dynamic Maps and Directions API, and displaying detailed place information upon interaction.\u003c/p\u003e\n"],["\u003cp\u003eCost considerations are outlined, highlighting API usage and billing based on the specific Google Maps Platform products involved in the local discovery experience.\u003c/p\u003e\n"]]],["This document details how to create a local discovery experience using Google Maps Platform APIs. Key actions include using the **Nearby Search (New) API** to surface relevant places near a specified location, filtering results with `includedTypes`, `excludedTypes`, `includedPrimaryTypes`, and `excludedPrimaryTypes`, and `locationRestriction`. The experience is enriched by using **Places Autocomplete**, **Directions API**, and **Places Details** for interactivity, detailed information, and visuals. Cost and billing considerations are also outlined for each API used.\n"],null,["In this document, you will look into how to use [Nearby Search (New) API](https://developers.google.com/maps/documentation/places/web-service/search-nearby-new)to\nbuild a simple and cost effective\n\nlocal discovery experience.\n\nA local discovery experience shows users key places of interest near a location\nyou specify when searching for a hotel or a real estate. It often consists of an\ninteractive map, with an additional panel containing a place chooser and a\ngallery of photos. You will be presented with different Google Maps Platform\nproducts and capabilities to enhance the experience with interactivity.\n\nUse Cases\n\nNow let's understand what elements of the local discovery integration drive user\nvalue:\n\n- **Discovery** - Give users an overview of what is around a single location\n by surfacing relevant places of various types.\n\n- **Interactivity** - Empower users to select a place and dynamically refresh the data\n\n relative to that place.\n- **Visualization** - Provide places reviews, photos\n\n and walking time and distance for the users to quickly understand if it fits\n their needs.\n\nReference Architecture\n\nLocal Discovery\n\nThere are many ways to create a local discovery experience. The following\nintegration is a **custom example** of a user experience that leverages well\nknown Google Maps Platform APIs as well as some exciting new features. If you\nwish to have a templated approach to local discovery you can use [Web\nComponents](https://github.com/googlemaps/extended-component-library/tree/main/place_overview).\n\nSample Application\n\nSample Walkthrough\n\nYou will find in the table below the sample application broken into steps\ntogether with a description of the technical implementation with Google Maps\nPlatform APIs.\n\n1. Location Search with AutocompleteSearch location\n\n- Load **Maps Javascript API**.\n- **Places Autocomplete** query or pick location on the map.\n\n2. Surface local points of interest using **[Nearby Search (New) API](https://developers.google.com/maps/documentation/places/web-service/search-nearby-new)**\n\n- Popularity ranking (more relevant results) or Distance ranking.\n- `includedTypes`, `excludedTypes` ; if you are a hotel you can exclude \"lodging\" type, and include only suited types, ie: \"restaurant, cafe, park, tourit_attraction\".\n- Leverage `includedPrimaryTypes`, `excludedPrimaryTypes` for even more control over results.\n- \\`locationRestriction to avoid insufficient number of results or too far away places ; in case of ZERO results, broaden the circle / rectangle size prior to display results.\n\nQuery sample when **booking a hotel** with Data fields requested:\n\n- Basic (`displayName`, `types`, `openingHours`, `formattedAddress`)\n- Contact (`websiteUri`, `nationalPhoneNumber`, `internationalPhoneNumber`)\n- Preferred (`reviews`, `priceLevel`, `userRatingCount`)\n\n```scdoc\n { \"includedTypes\": [\"restaurant\",\"cafe\",\"park\"], \"excludedTypes\":\n[\"lodging\",\"convenience_store\"], \"includedPrimaryTypes\":\n[\"restaurant\",\"tourist_attraction\",\"airport\"], \"excludedPrimaryTypes\":\n[\"lodging\"], \"maxResultCount\": 20, \"locationRestriction\": { \"circle\": {\n\"center\": { \"latitude\": 37.7937, \"longitude\": -122.3965 }, \"radius\": 500.0 } } }\n```\n\nQuery sample when **searching a real estate** with Data fields requested:\n\n- Basic (`displayName`, `types`, `openingHours`, `formattedAddress`)\n\n```scdoc\n { \"includedTypes\": [\"school\",\"transport\",\"bus\",\"convenience_store\"],\n\"excludedTypes\": [\"lodging\"], \"includedPrimaryTypes\":\n[\"restaurant\",\"tourist_attraction\",\"airport\"], \"excludedPrimaryTypes\":\n[\"lodging\"], \"maxResultCount\": 20, \"locationRestriction\": { \"circle\": {\n\"center\": { \"latitude\": 37.7937, \"longitude\": -122.3965 }, \"radius\": 500.0 } } }\n```\n\n3. Add **interactivity** with Dynamic Maps and Directions API\n\n- Up to date **leg and steps** by querying **[Directions\n API](https://developers.google.com/maps/documentation/directions/overview)**. \\* Use time in the next section.\n\n4. Display detailed information of the place upon interaction\n\n1. **Description** : `displayName`, `types`, `rating`, `userRatingCount`,\n `priceLevel`.\n\n **Time**: coming from the previous Directions API query.\n2. **Reviews** : `reviews[i].author`, `reviews[i].rating`,`reviews[i].text`.\n\n3. **Images** : during *Unrestricted Preview of Nearby Search (New) API* , you\n will have to query [Places\n Details](https://developers.google.com/maps/documentation/places/web-service/details)\n with [place.id](http://place.id) to get\n [photo_reference](https://developers.google.com/maps/documentation/places/web-service/details#Place-photos)\n to then query one at a time in your experience\n\nQueries count and cost associated\n\n- [Maps JavaScript\n API](https://developers.google.com/maps/documentation/javascript/usage-and-billing#pricing-for-product): 1 map at load of the experience.\n- Places Autocomplete API: 1 query every character typed (if using the [Autocomplete\n Widget](https://developers.google.com/maps/documentation/javascript/place-autocomplete)), it can be customised.\n- [Nearby Search (New)\n API](https://developers.google.com/maps/documentation/places/web-service/search-nearby-new): 1 query every 20 places displayed. Different billing according to [Place\n data](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing#data-skus) that are part of the query response.\n- [Directions\n API](https://developers.google.com/maps/documentation/directions/usage-and-billing#pricing-for-product): 1 query every place selected by the user.\n- [Place Photo\n API](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing#places-photo-new-ent-sku): 1 query every photo displayed.\n\nConclusion\n\nA local discovery experience is a powerful way to deliver user value. This\ndemonstration implementation has many features you are likely to include when\ncreating such an experience on Google Maps Platform with special capabilities\nfrom the [Nearby Search (New) API](https://developers.google.com/maps/documentation/places/web-service/search-nearby-new).\n\nNext Steps\n\nSuggested further reading:\n\n- [Web Components in the Maps JavaScript API](https://developers.google.com/maps/documentation/web-components/overview)\n- [Places Autocomplete Optimization](https://developers.google.com/maps/documentation/places/web-service/autocomplete#best-practices)\n- Other [Places Services](https://developers.google.com/maps/documentation/places/web-service/overview)\n- Leave feedback below.\n\nContributors\n\nPrincipal authors:\n\n[Thomas Anglaret](https://www.linkedin.com/in/thomas-anglaret/) \\| Google Maps\nPlatform Solutions Engineer"]]
