基本示例

重要：注意事项

请务必先仔细阅读注意事项。


获取位置

API提供基于位置的各项天气信息，所以第一步是获取位置，获取位置包括两种方式：
     第一种是通过经纬度定位，即上传经度和纬度接口将返回位置信息；
     第二种是通过文本搜索获取，例如上传搜索关键字“北京”，接口将返回“北京”的搜索结果；
     两种方式搜索到的位置信息，均包含Location Key（例如北京的Location Key为101924），它将被用于在随后获取该地点的预报、实况等数据。

  • 经纬度定位

    • 以下将展示一个经纬度定位的示例

    http://apidev.weathercn.com/locations/v1/cities/geoposition/search?q=35.07,103.71&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN

    输入以下信息，将为您计算一个可用的请求实例

    纬度      经度      API Key      Secret
    • URL:
    • (定位结果将在此显示)

     

     

  • 文本搜索

    •  

    以下将展示如何以名称（如：北京）搜索地点

    http://apidev.weathercn.com/locations/v1/cities/translate?q=北京&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN&alias=always

    输入以下信息，将为您计算一个可用的请求实例

    输入地点名称:      API Key      Secret
    • URL:
    • (搜索结果将在此显示)

      • 注：此接口自动识别搜索关键字的语言种类。

     

    逐日预报

    以下将展示一个逐日预报的示例

    http://apidev.weathercn.com/forecasts/v1/daily/{daynum}day/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN&details=true&metric=true

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      天数      API Key      Secret
    • URL:
    • (逐日预报结果将在此显示)

     

    逐小时预报

    以下将展示一个逐小时预报的示例

    http://apidev.weathercn.com/forecasts/v1/hourly/{hournum}hour/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN&metric=true

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      小时数      API Key      Secret
    • URL:
    • (逐小时预报结果将在此显示)

     

    天气实况

    以下将展示一个天气实况的示例

    http://apidev.weathercn.com/currentconditions/v1/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN&details=true

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      API Key      Secret
    • URL:
    • (天气实况结果将在此显示)

     

    预警

    以下将展示一个预警的示例

    http://apidev.weathercn.com/alerts/v1/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN&details=true

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      API Key      Secret
    • URL:
    • (预警结果将在此显示)

     

    指数

    以下将展示一个中国指数的示例

    http://apidev.weathercn.com/indices/v1/daily/1day/{locationKey}/groups/100?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      天数      API Key      Secret
    • URL:
    • (指数结果将在此显示)

    国外指数使用方式与中国指数不同，详见左侧菜单栏中“指数”部分

     

    空气质量

    以下将展示一个空气质量的示例

    http://apidev.weathercn.com/airquality/v1/global/observations/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}&language=zh-CN

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      API Key      Secret
    • URL:
    • (空气质量结果将在此显示)

     

    气候

    以下将展示一个气候的示例

    http://apidev.weathercn.com/climo/v1/actuals/yyyy/mm/{dd}/{locationKey}{.{format}}?apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}

    输入以下信息，将为您计算一个可用的请求实例

    LocationKey      日期      API Key      Secret
    • URL:
    • (气候结果将在此显示)

     

    自然语言理解

    以下将展示一个“自然语言理解”的示例，（注意本接口二级域名为api-ngdev）

    http://api-ngdev.weathercn.com/ng-nlp/v1/text?q=上海本周有雨么&apikey={your key}&requestDate={YYYYMMDDHHm UTC}&accessKey={通过secret计算生成的access key}

    输入以下信息，将为您计算一个可用的请求实例

    Text      API Key      Secret
    • URL:
    • (自然语言理解结果将在此显示)