資料說明
- 本API透過Google Geocoding API以經緯度取得完整地理資訊, ex: 地址、國家、行政區
- 此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
Request
# | 參數名稱 | 必填 | 說明 |
---|
1 | lat | 是 |
緯度
|
2 | lng | 是 |
經度
|
3 | 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 |
Response Example
{"data":{"country_name":"台灣","country":"TW","city":"台北市","district":"中山區","village":"新福里","zip_code":"104","street_number":"410","street":"松江路","full_address":"104台灣台北市中山區松江路410號","place_id":"ChIJUcChwFmpQjQRR7m2cyWXBtE","lat":25.06438,"lng":121.5329691,"url":"https://maps.google.com/?cid=ChIJUcChwFmpQjQRR7m2cyWXBtE"},"status":200}
錯誤代碼
status | 說明 |
---|
200 | 成功 |
400 | 發生錯誤 |
404 | Endpoint錯誤 |
500 | 系統錯誤 |