English
English
简体中文
Contact Us
Register
Log In
Cloud Services API ReferenceBasic APIsCountry and City InfoCity InfoGet City Information by Longitude and Latitude

Get City Information by Longitude and Latitude

Last Updated on : 2021-12-21 07:50:16download

Get detailed information about a specified city by longitude and latitude, including city ID, country name, and city name.

API address

GET: /v1.0/iot-03/cities/positions

Request parameter

Parameter name Type IN Required Description
lon String query true The longitude.
lat String query true The latitude.

Return parameter

Parameter name Type Description
result AreaRes The returned result.

Description of result

Parameter name Type Description
city_id String The ID of a specified city.
city_name String The name of a specified city.
province_name String The name of a specified province.
lon String The longitude.
parent_city_name String The name of the superior city.
country_name String The name of the country.
parent_id String The ID of a specified parent node.
lat String The latitude.

Request example

GET: /v1.0/iot-03/cities/positions?lon=112.908065&lat=27.866636

Return example

{ "result": { "parent_city_name": "Xiangtan City", "lon": "112.9080", "province_name": "Hunan Province", "city_name": "Xiangtan City", "parent_id": "793416838607409***", "country_name": "China", "lat": "27.8666", "city_id": "793409524550733***" }, "t": 1637833868025, "success": true }

Error code

For more information, see error code.