本文提供有關 Places API 的常見問題解答。如果在這裡找不到問題的解答,或許下列頁面能提供協助。
Places API 也有蓬勃發展的開發人員社群。如有程式碼相關問題,建議您在社群中發問。如要進一步瞭解如何發問,請參閱「支援」頁面。
搜尋地點
為什麼依類型篩選時,系統不會傳回某些地點?
你搜尋的地點可能尚未分類。在 Google 取得足夠的資料,將地點歸類為支援的地點類型之前,所有地點都會歸類為「establishment
」這類泛型。
解決方法是將地點 type
傳遞至 keyword
參數。keyword
參數會比對名稱、類型、地址和消費者評論。
如要自行將類別 type
新增至地點資訊,請提交地點編輯內容。編輯內容通過核准並發布後,系統就會使用正確的 type
篩選條件顯示內容。
為什麼系統未傳回某些附近的商家?
根據預設,Places API 會依據提供的 radius
內的 prominence
排序結果。Nearby Search 要求最多可傳回 60 筆結果,分別顯示在三個網頁中。如果某個地點在 prominence
中排名第 22,就會顯示在結果的第二頁,您可以透過分頁存取該頁面。
如果地點在 prominence
中的排名低於第 60 名,即使該地點離搜尋中心較近,也不會顯示在搜尋結果中。
您可以將查詢中的 rankby
參數設為 distance
,並省略 radius
參數,改為依 distance
排序結果,而非 prominence
。系統會忽略關聯性,並依與 location
的距離傳回地點。
如果您依類型篩選要求,部分結果可能會從回應中篩除。詳情請參閱常見問題項目:為什麼依類型篩選時,系統不會傳回某些地點?。
為什麼依某些 types
篩選時,最多只會收到兩項結果?
Places API 的設計宗旨是傳回附近 establishments
的清單 (支援地點類型第一張表格中的任何項目),以及最多兩個地點 (支援地點類型第二張表格中的任何項目) 結果,協助您識別要執行 Nearby Search 要求的區域。
依位置 type
篩選 Nearby Search 要求 (例如 locality
或 political
),系統就會濾除 establishment
結果。
地點資料
如何新增或編輯地點?
如果你是商家業主,可以使用商家檔案在 Google 地圖上新增、驗證及管理商家資訊。
如果不是地點擁有者,你還是可以建議變更。
疑難排解
為什麼我一直收到「status」:「REQUEST_DENIED」?
在下列情況下,Places API 會傳回 "status": "REQUEST_DENIED"
:
- 您尚未在 Google Cloud 控制台中啟用 Places API。
- 您的要求缺少
key
參數。 key
參數與 Google Cloud 控制台中的 API 金鑰不符。- 您尚未在 Google Cloud 控制台中正確設定 API 金鑰:
- 如果您使用設有瀏覽器限制的 API 金鑰,請檢查允許的參照網址是否正確。
- 如果您使用伺服器限制的 API 金鑰,請檢查允許的 IP 是否正確。
- 系統不支援設有 Android 或 iOS 限制的 API 金鑰。使用一般 (不受限制) 的 API 金鑰,或是設有瀏覽器或伺服器限制的金鑰。
- 要求並非以
HTTPS
要求的形式傳送,所有 Places API 要求都必須使用HTTPS
。 - 傳送要求時使用的
HTTP method
有誤。