資料說明
- 本API透過Google Geocoding API 以地址關鍵字查詢完整地理資訊, ex: 完整地址、國家、行政區、經緯度
- 若手頭上的地址資料不完整, 可以很方便地透過此API反查完整地址
- 亦可輸入地標名稱, 搭配 經緯度查完整地理資訊 取回地標地址
- 此API同一關鍵字查詢後緩存30天, 超過30天才會重新擷取
- 因Google Maps Geocoding API有每日使用次數及頻率限制.若您有大量資料轉換需求,強烈建議您使用自己的金鑰確保回覆正常.
我們保證不會儲存您的金鑰做任何其他用途, 取得Google API金鑰說明請 點此
3.建立金鑰-1
點選「憑證」>「建立憑證」>「API金鑰」
5.建立金鑰-3
您可輸入自訂的金鑰名稱,完成後點選「建立」
注:接受這些伺服器 IP 位址發出的要求 (選填) 請留空
6.金鑰建立完成
金鑰已建立完成, 稍後請填入此金鑰值
7.啟用API-1
專案總覽中選取Google Maps Geocoding API
Endpoint
GET http://api.opencube.tw/location/address
Request
# | 參數名稱 | 必填 | 說明 |
---|
1 | keyword | 是 |
地址關鍵字, 儘量輸入完整查詢結果較佳, 亦可輸入地標名稱
|
2 | key | 否 |
Google Maps Geocoding API金鑰, 建議您使用自己的金鑰確保回覆正常.
|
Response
# | 參數名稱 | 說明 |
---|
1 | country | 國碼, 可參考國碼查詢 |
2 | country_name | 國名 |
3 | city | 縣市, 可參考台灣縣市列表 |
4 | district | 行政區 |
5 | village | 里 |
6 | street | 路名 |
7 | street_number | 號 |
8 | zip_code | 郵遞區號 |
9 | full_address | 完整地址 |
10 | lat | 緯度 |
11 | lng | 經度 |
12 | place_id | Google Map PlaceID |
13 | url | Google Map Url |
14 | keyword | 關鍵字 |
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 | 發生錯誤 |
404 | Endpoint錯誤 |
500 | 系統錯誤 |