Query City

响应数据结构 (CityDataBaseOutput)

顶层字段

Cities 子项字段 (CityDatabaseEntry)

响应示例

{
  "IsSuccess": true,
  "Message": "Success",
  "Cities": [
    {
      "CityName": "Nanjing",
      "TypeOfCity": "AdministrationCenter",
      "ProvinceName": "Jiangsu",
      "CountryName": "CHINA",
      "ProvinceRank": 0,
      "Population": 0,
      "Latitude": 0.5595816528280128,
      "Longitude": 2.0730633043028854,
      "CentralBodyName": "Earth"
    }
  ]
}

注意事项

• 坐标系统:使用大地坐标系,纬度范围 [-90, 90],经度范围 [-180, 180]
• 高度单位:米 (m)
• 城市名称支持:英文或汉语拼音
• 城市类型:PopulatedPlace(人口聚集区)、AdministrationCenter(行政中心)、NationalCapital(国家首都)、TerritorialCapital(地区首府)

标准执行流程

1. 参数预检
   • 检查至少提供一个查询条件(cityName、provinceName、countryName 或 typeOfCity)
2. 请求构造
   • 按接口契约构造查询参数
3. 结果判定
   • 先判 HTTP 状态,再判 IsSuccess
   • IsSuccess = false 时优先返回 Message
4. 输出归一化
   • 给出查询条件摘要、执行状态、结果统计、详细数据

调用示例

场景 1:按城市名称查询

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/city?cityName=Beijing" \
  --request GET \
  --header 'Content-Type: application/json'

场景 2:按省份名称查询

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/city?provinceName=Hebei" \
  --request GET \
  --header 'Content-Type: application/json'

场景 3:按国家名称查询

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/city?cityName=Beijing&countryName=China" \
  --request GET \
  --header 'Content-Type: application/json'

场景 4:按城市类型查询(首都)

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/city?typeOfCity=NationalCapital" \
  --request GET \
  --header 'Content-Type: application/json'

场景 5:组合查询

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/city?countryName=China&typeOfCity=NationalCapital" \
  --request GET \
  --header 'Content-Type: application/json'