Places Web Service 常見問題

本文件包含 Places API 常見問題的解答。如果在這裡找不到問題的解答,可以參考以下部分頁面。

Places API 也有充滿活力的開發人員社群。如果您對程式碼有任何疑問,建議您將問題張貼至社群。如要進一步瞭解提問,請前往支援頁面

搜尋地點

為什麼依類型篩選時,系統沒有傳回某些地點?

您尋找的地點可能尚未分類。 所有地點都會歸類為一般類型「establishment」,直到 Google 擁有足夠的地點資訊,可將該地點歸類為支援的地點類型為止。

如要解決這個問題,您可以將地點 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 (例如 localitypolitical) 篩選 Nearby Search 要求時,會篩除 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 不正確:
    • 所有要求都必須以 GET 要求的形式傳送 ([Place Add][place-add] 除外)。
    • 所有 [地點新增][place-add] 要求都必須以 POST 要求的形式傳送。