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 (例如 locality 或 political) 篩選 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 有誤。