地址經緯度 API

用地址查經緯度，查過的地點都會記錄在資料庫，之後同一個地址直接回傳，不再重查。後台：/dashboard

驗證

每個請求帶 X-API-Key: 你的key 或 Authorization: Bearer 你的key。每個 Key 每分鐘 60 次。

查詢地址

curl -H "X-API-Key: KEY" \
  "https://address.tainanoutlook.com/api/v1/geocode?address=臺南市安平區國平里永華路二段551號"

{"found": true, "id": 1, "address": "臺南市安平區國平里永華路二段551號",
 "lat": 22.9899961, "lng": 120.1748756, "name": "", "description": "",
 "source": "gmap_url", "verified": true, "query_count": 3, ...}

比對時不分「台／臺」、空白與全形數字。資料庫沒有時，會先用 Google 地圖搜尋（source:google_auto），查不到再用 OpenStreetMap（source:nominatim，台灣門牌常不準），結果都存成未驗證（verified:false）；加 &fallback=0 可關閉。Google 查詢約需 5–10 秒。

其他端點

方法	路徑	說明
GET	/api/v1/places?q=&page=&honor=	列出／搜尋已記錄地點；honor 填殊榮編號或完整名稱可只列得獎地點
GET	/api/v1/honors	殊榮清單（名稱、主辦、年份、地點數）；每筆地點回傳的 honors 會列出它的殊榮與等級
GET	/api/v1/places/{id}	單筆
POST	/api/v1/places	新增，JSON：address、name、description，加 lat+lng 或 maps_url（Google 地圖網址）
PUT	/api/v1/places/{id}	更新（欄位同新增）
DELETE	/api/v1/places/{id}	刪除
POST	/api/v1/parse	JSON：url，從 Google 地圖網址解析經緯度（支援 maps.app.goo.gl 短網址）

怎麼從 Google 地圖取得經緯度

在 Google 地圖搜尋地址，網址列會出現 @22.9899961,120.1748756，前面是緯度、後面是經度。把整段網址貼到後台或 /api/v1/parse 即可自動解析（若網址含 !3d…!4d… 的標記點座標，會優先採用）。