全國省市區街道區域信息 API 接口
提供全國省市區街道區域信息。
1. 產品功能
- 提供全國最新、最全的省市區鎮街道區域信息;
- 第一時間更新區域信息變動;
- 最小級別可以詳細到鎮、街道級別,為國內區域單元最小級別;
- 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
- 全面兼容 Apple ATS;
- 全國多節點 CDN 部署;
- 接口極速響應,多台服務器構建 API 接口負載均衡。
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/chinaregions
接口請求地址: https://api.gugudata.com/location/chinaregions
返回格式: application/json; charset=utf-8
請求方式: GET
請求協議: HTTPS
請求示例: https://api.gugudata.com/location/chinaregions?appkey=YOUR_APPKEY®ioncode=YOUR_VALUE
接口測試: https://api.gugudata.com/location/chinaregions/demo
3. 請求參數(如果為 POST 請求,那么參數以 JSON 的格式傳遞)
參數名 | 參數類型 | 是否必須 | 默認值 | 備注 |
---|---|---|---|---|
appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY |
regioncode | string | 是 | YOUR_VALUE | 需要查詢的父級區域編碼,0 獲取全國所有省;編碼格式為 00000000,每兩位分別對應省、市、區、鎮/街道編碼 |
4. 返回參數
參數名 | 參數類型 | 備注 |
---|---|---|
DataStatus.StatusCode | int | 接口返回狀態碼 |
DataStatus.StatusDescription | string | 接口返回狀態說明 |
DataStatus.ResponseDateTime | string | 接口數據返回時間 |
DataStatus.DataTotalCount | int | 此條件下的總數據量,一般用於分頁計算 |
Data.RegionCode | string | 區域編碼 |
Data.RegionName | string | 區域名稱 |
Data.RegionType | string | 區域級別 |
5. 接口響應狀態碼
狀態碼 | 狀態碼解釋 | 備注 |
---|---|---|
100 | 正常返回 | 可通過判斷此狀態碼斷言接口正常返回 |
-1 | 請求失敗 | 請求處理請求失敗 |
501 | 參數錯誤 | 請檢查您傳遞的參數個數以及參數類型是否匹配 |
502 | 請求頻率受限 | 一般建議每秒請求不超過 100 次 |
503 | APPKEY 權限超限/訂單到期 | 請至開發者中心檢查您的 APPKEY 是否到期或是否權限超限 |
504 | APPKEY 錯誤 | 請檢查傳遞的 APPKEY 是否為開發者中心獲取到的值 |
505 | 請求的次數超出接口限制 | 請檢查對應接口是否有請求次數限制以及您目前的接口請求剩余次數 |
900 | 接口內部響應錯誤 | 接口可用性為 99.999%,如獲取到此狀態碼請郵件聯系我們 |
6. 開發語言請求示例代碼
示例代碼包含的開發語言:C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等,其他語言進行對應的 RESTful API 請求實現即可。
咕咕數據,專業的數據提供商,提供專業全面的數據接口、商業數據分析,讓數據成為您的生產原料。
咕咕數據基於我們五年來為企業客戶提供的海量數據支撐,將部分通用數據、通用功能抽象成產品級 API,大大滿足了用戶在產品開發過程中對基礎數據的需求,同時降低了復雜功能的實現門檻與人力成本。
除了我們已開放的分類數據與接口外,還有海量數據正在整理、清洗、整合、構建中,后期會開放更多的數據與雲端功能接口供用戶使用。
目前已開放的數據接口 API
- [條碼工具] 通用二維碼生成
- [條碼工具] Wi-Fi 無線網二維碼生成
- [條碼工具] 通用條形碼生成
- [圖像識別] 通用 OCR
- [圖像識別] HTML 轉 PDF
- [圖像識別] HTML 轉 Word
- [區域/坐標] 全國大學高校基礎信息
- [區域/坐標] 地理坐標逆編碼
- [區域/坐標] IP地址定位
- [區域/坐標] 全國省市區街道區域信息
- [區域/坐標] 地理坐標系轉換
- [元數據/字典] 歷年高考省錄取分數線
- [元數據/字典] 歷年高考高校錄取分數線
- [元數據/字典] 歷年高考專業錄取分數線
- [新聞/資訊] 軟件開發技術博文頭條
- [新聞/資訊] 獲取任意鏈接文章正文
- [新聞/資訊] 公眾號頭條文章
- [新聞/資訊] 獲取任意鏈接正文圖片
- [新聞/資訊] 獲取公眾號文章封面
- [新聞/資訊] 幽默笑話大全
- [短信/語音] 手機歸屬地查詢
- [文字/文本] 中文文本分詞
- [文字/文本] 中英文排版規范化
- [文字/文本] 百萬中國對聯數據
- [文字/文本] 簡體繁體互轉
- [文字/文本] 唐詩宋詞大全
- [文字/文本] 關鍵字摘要智能提取
- [天氣/空氣質量] 全國天氣預報信息
- [網站工具] 獲取任意站點標題與圖標
- [股票行情] A 股歷史行情數據
- [股票行情] 美股歷史行情數據
- [股票行情] 港股歷史行情數據
- [股票行情] 美股實時行情數據
- [股票行情] 港股實時行情數據
- [股票行情] A股實時行情數據
- [股票行情] 公募開放式基金歷史數據
- [體育/比賽] 歷年奧運比賽數據