City Lookup
City Lookup provides reverse geocoding, geolocation lookup services, supports multi-language, fuzzy search and other functions.
With the City Lookup, you can get the basic information of the city, including the Location ID of the city (you need this ID to get the weather), multilingual name, latitude and longitude, time zone, altitude, rank, administrative, etc.
In addition, GeoAPI - City Lookup can also help you to implement fuzzy search in your APP, users only need to type 1 or 2 words to get results.
Interface code | Interface | Class |
---|---|---|
geoCityLookUp | City lookup | GeoCityLookupResponse |
Parameters
GeoCityLookupParameter
-
location
(required)The location to be queried, support text, LocationID, comma-separated longitude and latitude (decimal, up to 2 decimal places), Adcode(Chinese cities only). For example:location=beijing
orlocation=116.41,39.92
-
adm
Superior administrative divisions of a city, useful for excluding cities with similar names or for filtering results. Exampleadm = beijing
-
range
Set to search only within a certain country or region. The country and region name needs to use country code ISO 3166. If this parameter is not set, the search range will be all cities. Example:range=cn
-
number
Number of the results in response, from 1 to 20, 10 is the default. -
lang
Multi-language setting, please see Language to find out how our multi-language works and how to set up.
Sample code
public void geoCityLookUp(GeoCityLookupParameter parameter, Callback<GeoCityLookupResponse> callback);
Response
GeoCityLookupResponse
-
code
See Status Code -
location.name
Location Name -
location.id
Location ID -
location.lat
Latitude of the location -
location.lon
Longitude of the location -
location.adm2
Name of the superior administrative division of the location -
location.adm1
The first-level administrative area of the location -
location.country
Country name of the location -
location.tz
Location timezone -
location.utcOffset
The number of hours offset between local time and UTC time, refer to UTC Offset -
location.isDst
Is the location currently on daylight saving time.1
for daylight saving time and0
for not in daylight saving time -
location.type
Location type -
location.rank
Location Rank -
location.fxLink
Responsive web page of this location, easy to embed in your website or APP -
refer.sources
Data source and other statements, may be null -
refer.license
Data license, may be null