全國省市區街道區域信息 API 接口


全國省市區街道區域信息 API 接口

提供全國省市區街道區域信息。

gugudata_api_cover

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&regioncode=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 請求實現即可。

image-20210629091827770

咕咕數據,專業的數據提供商,提供專業全面的數據接口、商業數據分析,讓數據成為您的生產原料。

image-20200716141435988

咕咕數據基於我們五年來為企業客戶提供的海量數據支撐,將部分通用數據、通用功能抽象成產品級 API,大大滿足了用戶在產品開發過程中對基礎數據的需求,同時降低了復雜功能的實現門檻與人力成本。

除了我們已開放的分類數據與接口外,還有海量數據正在整理、清洗、整合、構建中,后期會開放更多的數據與雲端功能接口供用戶使用。

目前已開放的數據接口 API


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM