API 參考

Google 評論連結 API

將一個 Google 地圖網址轉換為直接評論連結。無需註冊或 Google API 金鑰。

  1. 請求

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. 回應 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

支援的輸入

  • 特定地點的完整 Google 地圖網址
  • maps.app.goo.gl 分享連結
  • 舊版 goo.gl/maps 分享連結

請求

向端點傳送一個 JSON 物件。不接受商家名稱或單獨的 Place ID。

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

回應

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification 固定為 not_verified。將連結交給使用者前，請確認地點。

錯誤與處理方式

  • invalid_request (400)
    傳送含有非空白 maps_url 的有效 JSON。
  • unsupported_url (422)
    使用 Google 地圖中特定商家的分享連結。
  • unsafe_redirect (422)
    使用只會重新導向 Google 地圖的分享連結。
  • upstream_unresolved (502)
    開啟短連結，並傳送最終的完整地圖網址。
  • upstream_timeout (504)
    稍候再試一次，或傳送最終的完整地圖網址。

使用限制

匿名限制約為每個用戶端 IP 每分鐘 20 次請求。共用 IP 的代理會共用此額度。

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

邊緣產生的 429 回應可能沒有 JSON 內容或 Retry-After 標頭。請至少等候 60 秒，並逐次增加等候時間。

取得正確的地圖網址

  1. 在 Google 地圖開啟正確的商家地點。
  2. 確認分店名稱與地址，再選擇分享。
  3. 複製連結，並以 maps_url 傳送。

資料使用

成功的呼叫會記錄地點識別碼、語言、時間，以及可用時的商家大致位置。解析後的短網址會快取24小時。