Cloud Services API ReferenceGeneral ServiceCountry and City InfoCity InfoQuery City List

Query City List

Last Updated on : 2023-06-20 12:39:04download

Query a list of cities. Currently, only cities in China can be returned.

API address

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

Return parameter

Parameter name	Type	Description
result	List	The returned result.

Description of result

Parameter name	Type	Description
id	String	The ID of a specified province.
name	String	The name of a specified province.
cities	List	The list of cities under the province.

Description of cities

Parameter name	Type	Description
id	String	The ID of a specified city.
name	String	The name of a specified city.

Request example

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

Return example

{
    "result": [
        {
            "cities": [
                {
                    "name": "Fuzhou",
                    "id": "793409547065757***"
                },
                {
                    "name": "Xiamen",
                    "id": "793409547283861***"
                }
            ],
            "name": "Fujian Province",
            "id": "793416838519328***"
        }
    ],
    "t": 1631869578413,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet City Information by City ID

Next DocQuery City by Longitude and Latitude