使用規範

本API工具資料取自Google Geocoding API, 僅供您參考請勿用於其他用途. 使用時您必須遵守該資料源之使用限制Policies 以及 License Restrictions.

資料說明

  • 本API透過Google Geocoding API 以地址關鍵字查詢完整地理資訊, ex: 完整地址、國家、行政區、經緯度
  • 若手頭上的地址資料不完整, 可以很方便地透過此API反查完整地址
  • 亦可輸入地標名稱, 搭配 經緯度查完整地理資訊 取回地標地址
  • 此API同一關鍵字查詢後緩存30天, 超過30天才會重新擷取
  • 因Google Maps Geocoding API有每日使用次數及頻率限制.若您有大量資料轉換需求,強烈建議您使用自己的金鑰確保回覆正常.
    我們保證不會儲存您的金鑰做任何其他用途, 取得Google API金鑰說明請 點此

1.新增專案

若您尚未建立專案,請前往Google API Console 點選「新增專案」

2.輸入專案名稱

輸入您偏好的專案名稱

3.建立金鑰-1

點選「憑證」>「建立憑證」>「API金鑰」

4.建立金鑰-2

選擇伺服器金鑰

5.建立金鑰-3

您可輸入自訂的金鑰名稱,完成後點選「建立」
注:接受這些伺服器 IP 位址發出的要求 (選填) 請留空

6.金鑰建立完成

金鑰已建立完成, 稍後請填入此金鑰值

7.啟用API-1

專案總覽中選取Google Maps Geocoding API

8.啟用API-2

點選啟用即完成

Endpoint

GET http://api.opencube.tw/location/address

Request

#參數名稱必填說明
1keyword 地址關鍵字, 儘量輸入完整查詢結果較佳, 亦可輸入地標名稱
2key Google Maps Geocoding API金鑰, 建議您使用自己的金鑰確保回覆正常.

Response

#參數名稱說明
1country國碼, 可參考國碼查詢
2country_name國名
3city縣市, 可參考台灣縣市列表
4district行政區
5village
6street路名
7street_number
8zip_code郵遞區號
9full_address完整地址
10lat緯度
11lng經度
12place_idGoogle Map PlaceID
13urlGoogle Map Url
14keyword關鍵字

Response Example

{"data":{"keyword":"忠孝東路5段8號","country_name":"台灣","country":"TW","city":"台北市","district":"信義區","village":"興雅里","zip_code":"110","street_number":"8","street":"忠孝東路五段","full_address":"110台灣台北市信義區忠孝東路五段8號","place_id":"ChIJQeGuX7mrQjQRP9VT6aYl1_w","lat":25.0408461,"lng":121.5653964,"url":"https://maps.google.com/?cid=ChIJQeGuX7mrQjQRP9VT6aYl1_w"},"status":200}
        

錯誤代碼

status說明
200成功
400發生錯誤
404Endpoint錯誤
500系統錯誤
Close