在本文中，您將瞭解如何使用 Nearby Search (新版) API 建構簡單且經濟實惠的
本地探索體驗。
在地探索體驗會向使用者顯示特定地點附近的重要觀光景點 您在搜尋飯店或房地產時指定的代碼。通常由互動式地圖組成，並附加一個面板，其中包含地點選擇器和相片庫。您將看到不同的 Google 地圖平台產品和功能，可透過互動性提升使用體驗。
應用實例
接下來，我們來瞭解當地探索整合功能的哪些元素可為使用者帶來價值：
探索：顯示各種類型的相關地點，讓使用者一覽單一地點周遭的景點。
互動性 - 讓使用者選取地點並動態重新整理資料
而不是一個相對的
視覺化 - 提供地點評論和相片
和步行時間和距離，讓使用者快速瞭解是否符合需求。
參考架構
本區探索
打造本地探索體驗的方法有很多種，下列 整合是提供使用者體驗的自訂範例。 和一些實用的新功能。如果您想使用範本方法進行本機探索，可以使用Web 元件。
範例應用程式
範例逐步操作說明
您會在範例應用程式下方的表格中，看到分成多個步驟的表格。 以及 Google 地圖技術實作相關說明 平台 API
1. 根據 AutocompleteSearch 位置顯示 Location Search
- 載入 Maps JavaScript API。
- Place Autocomplete 查詢，或挑選地圖上的位置。
2. 使用 Nearby Search (新版) API 顯示當地景點
- 熱門程度排名 (關聯性更高的結果) 或距離排名。
includedTypes、excludedTypes；如果你是飯店，可以排除「住宿」類型，只納入適合的類型，例如「餐廳、咖啡廳、公園、tourit_attraction」。- 善用
includedPrimaryTypes、excludedPrimaryTypes，進一步控管結果。 - `locationRestriction，避免結果數量不足或距離太遠 地點；如果結果為 0，請擴大圓形 / 矩形的大小 即可顯示結果。
預訂飯店時的查詢範例，其中包含要求的資料欄位：
- 基本 (
displayName、types、openingHours、formattedAddress) - 聯絡資訊 (
websiteUri、nationalPhoneNumber、internationalPhoneNumber) - 首選 (
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 } } }搜尋房地產時的查詢範例，其中包含要求的資料欄位：
- 基本 (
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. 使用 Dynamic Maps and Directions API 新增互動功能
- 透過查詢路線 API，取得最新的路線和步驟。 * 在下一節中使用時間。
4. 在互動時顯示地點的詳細資訊
說明：
displayName、types、rating、userRatingCount、priceLevel。Time：來自前一個 Directions API 查詢。
評論：
reviews[i].author、reviews[i].rating、reviews[i].text。圖片：在Nearby Search (新版) API 無限制預先發布版期間，您必須使用
place.id查詢Places Details，才能取得 photo_reference，然後在您的體驗中一次查詢一個
查詢數量和相關費用
- 地圖 JavaScript API： 載入 1 個地圖。
- Places Autocomplete API：每輸入一個字元 (如果使用 自動完成 Widget)， 可以視需求自訂
- Nearby Search (新版) API： 顯示 20 個地點，共 1 個查詢。根據 Place 收費 資料 包含在查詢回應中的 Pod 中
- 路線 API： 使用者選取的每個地點，有 1 筆查詢。
- Place Photo API：每張顯示的相片需執行 1 次查詢。
結論
在地探索體驗是創造使用者價值的絕佳方式。這個 您的示範導入方法有很多功能 利用特殊功能在 Google 地圖平台上打造如此便利的體驗 透過 Nearby Search (新版) API 。
後續步驟
建議參閱以下文章：
- Maps JavaScript API 中的網頁元件
- Place Autocomplete 最佳化
- 其他地點介面集服務
- 請在下方提供意見。
貢獻者
主要作者：
湯瑪斯安格拉特 |Google 地圖 平台解決方案工程師