Locations API Guide

 

搜索类型：

 

列表

 

Location Key：

 

文本：

 

 

 

行政区域列表

Returns basic information about administrative areas. May be narrowed by countryCode.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/adminareas/{countryCode}{.{format}}{?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language={languageCode}}{&offset={zero based page number}}

 

示例:

http://apidev.weathercn.com/locations/v1/adminareas/us?offset=2&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

 

行政区域列表搜索

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/adminareas/{countryCode}/search{.{format}}?q={search text}{&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language={languageCode}}

 

示例:

http://apidev.weathercn.com/locations/v1/adminareas/US/search?q=pennsylvania&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

国家列表

Returns basic information about countries. May be narrowed by regionCode.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/countries/{regionCode}{.{format}}?{apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language= {languageCode}}

 

示例:

http://apidev.weathercn.com/locations/v1/countries/nam?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

 

国家搜索

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/countries/search{.{format}}?q={search text}{&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language={languageCode}}

 

示例:

http://apidev.weathercn.com/locations/v1/countries/search?q=España&language=es&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

区域列表

Returns basic information about all regions.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/regions/{regionCode}{.{format}}{?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language={languageCode}}

 

示例:

http://apidev.weathercn.com/locations/v1/regions.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

热门城市列表

Returns basic information for the top 50, 100, or 150 cities, worldwide.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/topcities/{group}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/topcities/50.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

 

按Location Key搜索

Returns information about a specific location, by location key. You must know the location key to perform this query.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details=true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/335315.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

按Location Key搜索城市周边

Returns information about neighboring cities, by location key. You must know the location key to perform this query.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/cities/neighbors/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key} {&language={language code}}{&details={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/neighbors/623.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

城市搜索

Searches the specified language for the queried city name and returns results in the specified language. Compare this response to the response obtained from the City Search with Translation query for "Roma."

http://{{api} or {{apidev}}.weathercn.com/locations/ {version}/cities/{countryCode}/{adminCode}/search{.{format}}?q={city name}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/search.json?q=roma&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&language=en-us

顶部

 

 

城市搜索（集成翻译功能）

Searches all languages for the queried city name and returns results in the specified language. Compare this response to the response obtained from the City Search query for "Roma."

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/cities/{countryCode}/{adminCode}/translate{.{format}}?q={city name}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/translate.json?q=roma&language=en-us&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

兴趣点搜索

Searches the specified language for the queried point of interest name and returns results in the specified language.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/poi/{countryCode}/{adminCode}/search{.{format}}?q={point of interest}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&type={poi type}}{&language={language code}}{&details={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/poi/US/CA/search?q=Disney Studios&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&details=true

顶部

 

 

兴趣点搜索（集成翻译功能）

Searches all languages for the queried point of interest name and returns results in the specified language.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/poi/{countryCode}/{adminCode}/translate{.{format}}?q={point of interest}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&type={poi type}}{&language={language code}}{&details={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/poi/translate?q=Disney Studios&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&language=zh-cn

顶部

 

 

邮政编码搜索

Returns information for an array of postal codes that match the search text.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/postalcodes/{countryCode}/search{.{format}}?q={postal code}{&language={language code}}{&details={true or false}}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

 

示例:

http://apidev.weathercn.com/locations/v1/postalcodes/search.json?q=90210&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

文本搜索

Searches the specified language and returns information in the specified language for an array of locations that match the search text. 

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/{countryCode}/{adminCode}/search.{.{format}}?q={search text}&apiKey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}}

 

示例:

http://apidev.weathercn.com/locations/v1/fr/search?q=paris&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&language=fr&details=true

http://apidev.weathercn.com/locations/v1/search?q=16801&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

文本搜索（集成翻译功能）

Searches all languages and returns information in the specified languages for an array of locations that match the search text.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/{countryCode}/{adminCode}/translate{.{format}}?q={search text}&apiKey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}}

 

示例:

http://apidev.weathercn.com/locations/v1/translate?q=tokyo&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&language=de

顶部

 

 

自动完成

Returns basic information about cities matching an autocomplete of the search text.

http://{{api} or {{apidev}}.weathercn.com/locations/ {version}/cities/{countryCode}/autocomplete{.{format}}?q={location}{&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&language={language code}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/autocomplete?q=new&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

http://apidev.weathercn.com/locations/v1/cities/autocomplete.json?q=nue&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}&language=es

顶部

 

 

通过GeoPosition搜索城市和兴趣点（纬度/经度）

Returns information about a specific location, by Geoposition (latitude and longitude). Response includes Cities and POIs.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/geoposition/search.json?q=40.78, -77.89&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

通过GeoPosition搜索城市（纬度/经度）

Returns information about a specific location, by Geoposition (latitude and longitude). Response includes cities.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/cities/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/geoposition/search.json?q=40.78, -77.89&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

通过GeoPosition搜索兴趣点（纬度/经度）

Returns information about a specific location, by Geoposition (latitude and longitude). Response includes Points of Interest.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/poi/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/poi/geoposition/search.json?q=40.78, -77.89&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

IP地址搜索

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/cities/ipaddress{.{format}}?q={ip address}{&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}}{&details={true or false}}

 

示例:

http://apidev.weathercn.com/locations/v1/cities/ipaddress?q=38.103.173.150&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部

 

 

Partner ID搜索

Returns details about all display partners, or a specific display partner.

http://{{api} or {{apidev}}.weathercn.com/locations/{version}/partners/{partnerID}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

 

示例:

http://apidev.weathercn.com/locations/v1/partners.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

http://apidev.weathercn.com/locations/v1/partners/3.json?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={access key}

顶部