NAV Navbar

Introduction

感謝您使用 台灣圖霸 「尊爵版」: 最適合房仲業不動產物件的學區查詢 API!

讓您可以透過給定地理經緯度座標,直接取回該座標所屬的國中、國小學區。

台灣圖霸 尊爵版房仲業學區查詢 API -- 簡單、方便、好用、準確。

Notation

  1. 左右鍵符號 (大於、小於符號, 也就是 < >) 所描述的是一個變數 (variable) 的 formal parameter 形式。本文件底下若提及參數部分,使用到此表示法時,請讀者將之代換成實際的內容 (也就是代換為 actual parameter,並且,不留下 < > 符號)。例如, https://api.map8.zone/find?keyword=<關鍵詞> 若實際關鍵詞為 taiwan,則實際呼叫時,應代換為 https://api.map8.zone/find?keyword=taiwan
  2. 位於 API 欄位內格式的 <參數>,為標準的 URL 之 query string 格式編碼 (i.e., name=value 以 URL % 編碼, 並以 & 連接)
  3. 除非另有指定,否則,地理經緯度座標 (lat 或 latitude 均指經度,lng 或 longitude 均指緯度) 以 WGS84 / EPSG:4326 為地理座標系統

Version

API Index

Map8 Premium 尊爵版

尊爵版 : [Housing] School Districts API

Syntax

https://api.map8.zone/v2/premium/housing/schooldistricts?key=<您的 key>&location=<緯度>,<經度>&kind=<國中 | 國小>

Example : 查詢座標 24.868242, 121.206504 所屬之國小學區

curl -X GET "https://api.map8.zone/v2/premium/housing/schooldistricts?location=24.868242%2C121.206504&kind=國小&key=<您的 key>"
{
  "html_attribution": [
    "台灣圖霸",
    "研鼎智能",
    "PAPAGO!"
  ],
  "results": [
    {
      "place_id": "NzYqAQYDRxkHXF1TEjlZU1E6Ly5LVBADPA4Oc1xdPk4NSy1HWGsCEg==", 
      "city": "台南市",
      "town": "龍潭區",
      "name": "龍潭國小",
      "kind": "國小"
    }
  ],
  "status": "OK"
}

功能 : 查詢所給定的地理經緯度座標之所屬學區 (國中、國小)





台灣圖霸感謝您的支持與愛護!

有任何疑問,或是指教,都非常歡迎您找我們詢問。

非常感謝!



https://map8.zone

HTTP Status Code

以上 API,可能回傳的 HTTP status code 如后 :

Error Code 意義
400 Bad Request -- 表示您的 requset 解析有誤。通常是給入的參數多了或少了,或是格式有錯誤,或必要參數卻沒給,等等
401 Unauthorized -- 表示您未給定您的 key,或是您給的 key 並非有效。請跟我們聯絡
503 Service Unavailable -- 表示您的 request 已經超出與我們約定的 QoS (服務品質) 等級。通常過一會兒 (QoS 上限解除) 再重發一次即可成功。如果持續發生,請跟我們聯絡

"status" 欄位

以上 API,可能回傳之 status 欄位的意義為 :

status 意義
OK 無發生任何錯誤;該地點被成功偵測,並且至少回傳一則結果
ZERO_RESULTS 表示搜尋雖然完成,但未得到任何有效結果。此狀況譬如可能發生在您對本 API 發出的 request 所給定的中心座標在一個不適當的地點
OVER_QUERY_LIMIT 表示您已經超出您的配額。請跟我們聯絡
REQUEST_DENIED 表示您的 request 無法進行;一般來說是您未給定您的 key,或是您給的 key 並非有效。請跟我們聯絡
INVALID_REQUEST 表示您的 requset 解析有誤。通常是給入的參數多了或少了,或是格式有錯誤,或必要參數卻沒給,等等
UNKNOWN_ERROR 表示是我們的伺服器端的錯誤;再重試一次可能就會成功。如果持續發生此問題,請跟我們聯絡