使用規範

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

資料說明

  • 本API透過Google Geocoding API以經緯度取得完整地理資訊, ex: 地址、國家、行政區
  • 此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

Request

#參數名稱必填說明
1lat 緯度
2lng 經度
3key 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

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發生錯誤
404Endpoint錯誤
500系統錯誤
Close