### GET /v3/staticmap Source: https://lbs.amap.com/api/webservice/guide/api/staticmaps 获取静态地图图片。通过 HTTP GET 请求返回一张地图图片，可指定地图位置、大小、缩放级别以及添加标注、标签、折线、多边形等覆盖物。 ```APIDOC ## [GET] /v3/staticmap ### Description 获取静态地图图片。通过 HTTP GET 请求返回一张地图图片，可指定地图位置、大小、缩放级别以及添加标注、标签、折线、多边形等覆盖物。 ### Method GET ### Endpoint https://restapi.amap.com/v3/staticmap?parameters ### Parameters #### Query Parameters - **key** (string) - Required - 用户唯一标识，用户在高德地图官网申请。 - **location** (string) - Optional (部分条件必填) - 地图中心点坐标，经度和纬度用","分隔，经纬度小数点后不得超过6位。 - **zoom** (integer) - Required - 地图缩放级别，范围[1,17]。 - **size** (string) - Optional - 图片宽度*图片高度，最大值为1024*1024，默认值400*400。 - **scale** (integer) - Optional - 普通/高清，1:返回普通图；2:调用高清图，图片高度和宽度都增加一倍，zoom也增加一倍（当zoom为最大值时，zoom不再改变），默认值1。 - **markers** (string) - Optional - 标注，使用规则见markers详细说明，标注最大数10个。 - **labels** (string) - Optional - 标签，使用规则见labels详细说明，标签最大数10个。 - **paths** (string) - Optional - 折线，使用规则见paths详细说明，折线和多边形最大数4个。 - **traffic** (integer) - Optional - 交通路况标识，0不展现，1展现，默认值0。 - **sig** (string) - Optional - 数字签名，数字签名认证用户必填。 ### Request Example ``` https://restapi.amap.com/v3/staticmap?location=116.481485,39.990464&zoom=10&size=750*300&markers=mid,,A:116.481485,39.990464&key=<用户的key> ``` ### Response #### Success Response (200) 返回一张地图图片（图片格式，如PNG）。 #### Response Example （图片数据） ``` -------------------------------- ### Bus Stop ID Inquiry Request Example Source: https://lbs.amap.com/api/webservice/guide/api-advanced/bus-inquiry An example of a GET request to the bus stop ID inquiry endpoint using a specific stop ID and XML output format. ```http https://restapi.amap.com/v3/bus/stopid?key=<用户的key>&id=BV10006672&output=xml ``` -------------------------------- ### GET /v5/direction/walking Source: https://lbs.amap.com/api/webservice/guide/api/newroute 步行路线规划 API，用于获取从起点到目的地的步行路线方案。用户需提供高德 Key、起点和终点坐标，可选参数包括备选路线数量、返回字段控制等。 ```APIDOC ## GET /v5/direction/walking ### Description 获取步行路线规划方案，根据起点和终点坐标计算步行路线，支持返回多条备选路线和详细导航指令。 ### Method GET ### Endpoint https://restapi.amap.com/v5/direction/walking ### Parameters #### Query Parameters - **key** (string) - Required - 用户在高德地图官网申请的 Web 服务 API 类型 Key。 - **origin** (string) - Required - 起点信息，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。 - **destination** (string) - Required - 目的地信息，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。 - **origin_id** (string) - Optional - 起点 POI ID，起点为 POI 时建议填充，可提升路线规划准确性。 - **destination_id** (string) - Optional - 目的地 POI ID，目的地为 POI 时建议填充，可提升路线规划准确性。 - **alternative_route** (string) - Optional - 返回路线条数，1：多备选路线中第一条路线，2：多备选路线中前两条路线，3：多备选路线中三条路线，不传则默认返回一条路线方案。 - **show_fields** (string) - Optional - 返回结果控制，用来筛选 response 结果中可选字段，多个字段间采用","进行分割，未设置时只返回基础信息类内字段。 - **sig** (string) - Optional - 数字签名，请参考数字签名获取和使用方法。 - **isindoor** (string) - Optional - 是否需要室内算路，0：不需要，1：需要，默认0。 - **output** (string) - Optional - 返回结果格式类型，可选值：JSON，默认json。 - **callback** (string) - Optional - 回调函数，callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。 ### Request Example https://restapi.amap.com/v5/direction/walking?isindoor=0&origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key> ### Response #### Success Response (200) - **status** (string) - 本次 API 访问状态，如果成功返回1，如果失败返回0。 - **info** (string) - 访问状态值的说明，如果成功返回"ok"，失败返回错误原因。 - **infocode** (string) - 返回状态说明，10000代表正确。 - **count** (string) - 路径规划方案总数。 - **route** (object) - 返回的规划方案列表。 - **origin** (string) - 起点经纬度。 - **destination** (string) - 终点经纬度。 - **paths** (object) - 算路方案详情。 - **distance** (string) - 方案距离，单位：米。 - **steps** (object) - 路线分段。 - **instruction** (string) - 步行指示。 - **orientation** (string) - 进入道路方向。 - **road_name** (string) - 分段道路名称。 - **step_distance** (string) - 分段距离信息。 - 注意以下字段如果需要返回，需要通过"show_fields"进行参数类设置。 - **cost** (object) - 设置后可返回方案所需时间及费用成本。注意：steps 中不返回 taxi 字段。 - **duration** (string) - 线路耗时，包括方案总耗时及分段 step 中的耗时，单位：秒。 - **taxi** (string) - 预估打车费用。 - **navi** (object) - 设置后可返回详细导航动作指令。 - **action** (string) - 导航主要动作指令。 - **assistant_action** (string) - 导航辅助动作指令。 - **walk_type** (string) - 算路结果中存在的道路类型：0，普通道路 1，人行横道 3，地下通道 4，过街天桥5，地铁通道 6，公园 7，广场 8，扶梯 9，直梯10，索道 11，空中通道 12，建筑物穿越通道13，行人通道 14，游船路线 15，观光车路线 16，滑道18，扩路 19，道路附属连接线 20，阶梯 21，斜坡22，桥 23，隧道 30，轮渡。 - **polyline** (string) - 设置后可返回分路段坐标点串，两点间用","分隔。 #### Response Example （未提供具体响应示例） ``` -------------------------------- ### GET https://restapi.amap.com/v5/direction/electrobike Source: https://lbs.amap.com/api/webservice/guide/api/newroute 电动车（骑行）路线规划 API，通过 GET 请求获取电动车骑行路线方案。需要提供起点和终点经纬度，并支持可选参数控制返回结果。 ```APIDOC ## GET https://restapi.amap.com/v5/direction/electrobike ### Description 电动车（骑行）路线规划 API，通过 GET 请求获取电动车骑行路线方案。需要提供起点和终点经纬度，并支持可选参数控制返回结果。 ### Method GET ### Endpoint https://restapi.amap.com/v5/direction/electrobike ### Parameters #### Query Parameters - **key** (string) - 必填 - 用户在高德地图官网申请的 Web 服务 API 类型 Key。 - **origin** (string) - 必填 - 起点经纬度，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。 - **destination** (string) - 必填 - 目的地，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。 - **show_fields** (string) - 可选 - 返回结果控制，用来筛选 response 结果中可选字段。多个字段间采用","进行分割。未设置时只返回基础信息类内字段。 - **alternative_route** (string) - 可选 - 返回方案条数，1：多备选路线中第一条路线，2：多备选路线中前两条路线，3：多备选路线中三条路线，不传则默认返回一条路线方案。 - **sig** (string) - 可选 - 数字签名，请参考数字签名获取和使用方法。 - **output** (string) - 可选 - 返回结果格式类型，可选值：JSON，缺省值为 json。 - **callback** (string) - 可选 - 回调函数，callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。 ### Request Example https://restapi.amap.com/v5/direction/electrobike?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key> ### Response #### Success Response (200) - **status** (string) - 本次 API 访问状态，如果成功返回1，如果失败返回0。 - **info** (string) - 访问状态值的说明，如果成功返回"ok"，失败返回错误原因。 - **infocode** (string) - 返回状态说明，10000代表正确。 - **count** (string) - 路径规划方案总数。 - **route** (object) - 返回的规划方案列表。 - **origin** (string) - 起点经纬度。 - **destination** (string) - 终点经纬度。 - **paths** (object) - 算路方案详情。 - **distance** (string) - 方案距离，单位：米。 - **steps** (object) - 路线分段。 - **instruction** (string) - 骑行指示。 - **orientation** (string) - 进入道路方向。 - **road_name** (string) - 分段道路名称。 - **step_distance** (string) - 分段距离信息。 - **cost** (object) - 设置后可返回方案所需时间及费用成本。 - **duration** (string) - 线路耗时，包括方案总耗时及分段step中的耗时，单位：秒。 - **navi** (object) - 设置后可返回详细导航动作指令。 - **action** (string) - 导航主要动作指令。 - **assistant_action** (string) - 导航辅助动作指令。 - **walk_type** (string) - 算路结果中存在的道路类型。 - **polyline** (string) - 设置后可返回分路段坐标点串，两点间用","分隔。 #### Response Example （未提供） ``` -------------------------------- ### GET https://restapi.amap.com/v3/assistant/inputtips Source: https://lbs.amap.com/api/webservice/guide/api-advanced/inputtips 根据用户输入的关键词查询返回建议列表。该接口支持可选参数如类型、坐标、城市等，并返回 JSON 或 XML 格式的数据。 ```APIDOC ## [GET] https://restapi.amap.com/v3/assistant/inputtips ### Description 根据用户输入的关键词查询返回建议列表。 ### Method GET ### Endpoint https://restapi.amap.com/v3/assistant/inputtips ### Parameters #### Query Parameters - **key** (string) - Required - 请求服务权限标识，用户在高德地图官网申请的 Web 服务 API 类型 KEY。 - **keywords** (string) - Required - 查询关键词。 - **type** (string) - Optional - POI 分类，支持多个分类，用“|”分隔。可选值：POI 分类名称、分类代码。建议使用分类代码。 - **location** (string) - Optional - 坐标，格式：“X,Y”（经度,纬度），不可以包含空格。建议使用此参数，可在此 location 附近优先返回搜索关键词信息。在请求参数 city 不为空时生效。 - **city** (string) - Optional - 搜索城市，可选值：citycode、adcode，不支持县级市。如：010/110000。填入此参数后，会尽量优先返回此城市数据，但不一定仅局限此城市结果。 - **citylimit** (boolean) - Optional - 仅返回指定城市数据，可选值：true/false。缺省值为 false。 - **datatype** (string) - Optional - 返回的数据类型，多种数据类型用“|”分隔。可选值：all（返回所有数据类型）、poi（返回POI数据类型）、bus（返回公交站点数据类型）、busline（返回公交线路数据类型）。缺省值为 all。 - **sig** (string) - Optional - 数字签名，请参考数字签名获取和使用方法。 - **output** (string) - Optional - 返回数据格式类型，可选值：JSON、XML。缺省值为 JSON。 - **callback** (string) - Optional - 回调函数，callback 值是用户定义的函数名称，此参数只在 output=JSON 时有效。 ### Request Example https://restapi.amap.com/v3/assistant/inputtips?output=xml&city=010&keywords=招商银行&key=<用户的key> ### Response #### Success Response (200) - **status** (string) - 返回状态，值为0或1：1成功；0失败。 - **info** (string) - 返回的状态信息，status 为0时，info 返回错误原因；否则返回“OK”。 - **count** (string) - 返回结果总数目。 - **tips** (array) - 建议提示列表。 - **tip** (object) - 提示信息。 - **id** (string) - 返回数据 ID，若数据为 POI 类型，则返回 POI ID；若数据为 bus 类型，则返回 bus id；若数据为 busline 类型，则返回 busline id。 - **name** (string) - tip 名称。 - **district** (string) - 所属区域，省+市+区（直辖市为“市+区”）。 - **adcode** (string) - 区域编码，六位区县编码。 - **location** (string) - tip 中心点坐标，当搜索数据为 busline 类型时，此字段不返回。 - **address** (string) - 详细地址。 #### Response Example { "status": "1", "info": "OK", "count": "1", "tips": [ { "id": "B000A7BD1E", "name": "招商银行(北京分行)", "district": "北京市朝阳区", "adcode": "110105", "location": "116.466027,39.920850", "address": "朝阳门外大街16号" } ] } ``` -------------------------------- ### GET /position Source: https://lbs.amap.com/api/webservice/guide/api-advanced/hardware-location 智能硬件定位 API 服务地址，通过上传 WIFI 和基站信息实现定位，返回经纬度和其他位置信息。 ```APIDOC ## [GET] https://apilocate.amap.com/position?parameters ### Description 智能硬件定位 API 使用 HTTP 协议访问远程服务的接口，支持通过服务端上传 WIFI 和基站信息来实现定位，进而获取经纬度和其他位置信息。 ### Method GET ### Endpoint https://apilocate.amap.com/position?parameters ### Parameters #### Query Parameters - **key** (string) - Required - 请求服务权限标识，用户在高德地图官网申请 Web 服务 API 类型 Key。 - **accesstype** (string) - Required - 移动端接入网络方式，可选值：0（移动接入网络）、1（wifi 接入网络）。 - **imei** (string) - Optional - 手机 imei 号，能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查。 - **idfa** (string) - Required (与 imei 必填一个) - ios 手机的 idfa，能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查。 - **smac** (string) - Optional - 手机 mac 码，能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查。 - **serverip** (string) - Optional - 设备接入基站时对应的网关 IP，能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查。 - **cdma** (string) - Required when accesstype=0 - 是否为 cdma，非 cdma：0，是 cdma：1。缺省值为 0。 - **imsi** (string) - Optional - 移动用户识别码，能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查。 - **network** (string) - Required when accesstype=0 - 无线网络类型，可选值：GSM/GPRS/EDGE/HSUPA/HSDPA/WCDMA。 - **tel** (string) - Optional - 手机号码。 - **bts** (string) - Required when accesstype=0 - 接入基站信息，非 CDMA 格式为：mcc,mnc,lac,cellid,signal；CDMA 格式为：sid,nid,bid,lon,lat,signal，其中 lon,lat 可为空，格式为：sid,nid,bid,,,signal。 - **nearbts** (string) - Optional - 周边基站信息（不含接入基站信息），格式为：基站信息 1|基站信息 2|基站信息 3…..。 - **mmac** (string) - Optional - 已连热点 mac 信息，格式为：mac,signal,ssid。 - **macs** (string) - Required when accesstype=1 - wifi 列表中 mac 信息，单 mac 信息同 mmac，mac 之间使用“|”分隔。必须填写 2 个及 2 个以上,30 个以内的方可正常定位。请不要包含移动 wifi 信息。 - **output** (string) - Optional - 返回数据格式类型，可选值：JSON | XML，缺省值为 JSON。 ### Request Example https://apilocate.amap.com/position?accesstype=1&bts=460%2C0%2C29744%2C267330583%2C109&nearbts=460%2C0%2C29744%2C34467715%2C121&macs=0e%3A6f%3Ab0%3A6e%3Af1%3A1c%2C-63%2Ca|d8%3Ae8%3A44%3A5f%3A99%3A23%2C-64%2Ca|5a%3Abe%3A72%3A5a%3A6d%3A54%2C-64%2Ca|ba%3A60%3A61%3Abb%3Ade%3A93%2C-65%2Ca|da%3Ae8%3A44%3A1f%3A99%3A23%2C-65%2Ca|78%3A60%3A5b%3Ab2%3Ad7%3A06%2C-66%2Ca&cdma=0&imei=15030518977&output=json&platform=rest&key=<用户的key> ### Response #### Success Response (200) - **status** (string) - 返回结果状态值，值为 0 或 1，0 表示失败；1 表示成功。 - **info** (string) - 返回状态说明，status 为 0 时，info 返回错误原因，否则返回“OK”。 - **result** (object) - 定位结果列表。 - **type** (string) - 定位类型，0：没有得到定位结果；其他数字为：正常获取定位结果。 - **imei** (string) - 手机 imei 号。 - **location** (string) - 定位经纬度。 - **radius** (string) - 定位精度半径，单位：米。 - **desc** (string) - 位置描述。 - **country** (string) - 国家，非必返回。 - **province** (string) - 省份，非必返回。 - **city** (string) - 城市，非必返回。 - **citycode** (string) - 城市编码，非必返回。 - **adcode** (string) - 区域编码，非必返回。 - **road** (string) - 道路名，非必返回。 - **poi** (string) - 定位附近的 poi 名称，非必返回。 #### Response Example { "status": "1", "info": "OK", "result": { "type": "1", "imei": "15030518977", "location": "116.397428,39.90923", "radius": "50", "desc": "北京市朝阳区望京街道" } } ### Error Handling - **INVALID_USER_KEY** - 用户 key 非法或过期 - **SERVICE_NOT_EXIST** - 请求服务不存在 - **SERVICE_RESPONSE_ERROR** - 请求服务响应错误 - **INSUFFICIENT_PRIVILEGES** - 无权限访问此服务 - **OVER_QUOTA** - 请求超出配额 - **INVALID_PARAMS** - 请求参数非法 - **UNKNOWN_ERROR** - 未知错误 ``` -------------------------------- ### GET https://restapi.amap.com/v5/direction/bicycling Source: https://lbs.amap.com/api/webservice/guide/api/newroute 骑行路线规划 API，用于获取骑行路径规划方案。通过 GET 请求调用，需要提供起点和终点经纬度坐标，可设置返回方案条数、返回字段等可选参数。 ```APIDOC ## GET https://restapi.amap.com/v5/direction/bicycling ### Description 骑行路线规划 API，用于获取骑行路径规划方案。通过 GET 请求调用，需要提供起点和终点经纬度坐标，可设置返回方案条数、返回字段等可选参数。 ### Method GET ### Endpoint https://restapi.amap.com/v5/direction/bicycling?parameters ### Parameters #### Query Parameters - **key** (string) - 必填 - 用户在高德地图官网申请 Web 服务 API 类型 Key - **origin** (string) - 必填 - 起点经纬度，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位 - **destination** (string) - 必填 - 目的地，经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位 - **show_fields** (string) - 可选 - 返回结果控制，用来筛选 response 结果中可选字段。多个字段间采用","进行分割；show_fields 未设置时，只返回基础信息类内字段。缺省值为空 - **alternative_route** (string) - 可选 - 返回方案条数：1：多备选路线中第一条路线；2：多备选路线中前两条路线；3：多备选路线中三条路线；不传则默认返回一条路线方案。缺省值为空 - **sig** (string) - 可选 - 数字签名，请参考数字签名获取和使用方法。缺省值为无 - **output** (string) - 可选 - 返回结果格式类型，可选值：JSON。缺省值为 json - **callback** (string) - 可选 - 回调函数，callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。缺省值为无 ### Request Example https://restapi.amap.com/v5/direction/bicycling?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key> ### Response #### Success Response - **status** (string) - 本次 API 访问状态，如果成功返回1，如果失败返回0 - **info** (string) - 访问状态值的说明，如果成功返回"ok"，失败返回错误原因 - **infocode** (string) - 返回状态说明，10000代表正确 - **count** (string) - 路径规划方案总数 - **route** (object) - 返回的规划方案列表 - **origin** (string) - 起点经纬度 - **destination** (string) - 终点经纬度 - **paths** (object) - 算路方案详情 - **distance** (string) - 方案距离，单位：米 - **steps** (object) - 路线分段 - **instruction** (string) - 骑行指示 - **orientation** (string) - 进入道路方向 - **road_name** (string) - 分段道路名称 - **step_distance** (string) - 分段距离信息 注意以下字段如果需要返回，需要通过"show_fields"进行参数类设置： - **cost** (object) - 设置后可返回方案所需时间及费用成本 - **duration** (string) - 线路耗时，包括方案总耗时及分段step中的耗时，单位：秒 - **navi** (object) - 设置后可返回详细导航动作指令 - **action** (string) - 导航主要动作指令 - **assistant_action** (string) - 导航辅助动作指令 - **walk_type** (string) - 算路结果中存在的道路类型：0，普通道路；1，人行横道；3，地下通道；4，过街天桥；5，地铁通道；6，公园；7，广场；8，扶梯；9，直梯；10，索道；11，空中通道；12，建筑物穿越通道；13，行人通道；14，游船路线；15，观光车路线；16，滑道；18，扩路；19，道路附属连接线；20，阶梯；21，斜坡；22，桥；23，隧道；30，轮渡 - **polyline** (string) - 设置后可返回分路段坐标点串，两点间用","分隔 ``` -------------------------------- ### GET https://et-api.amap.com/event/queryByAdcode Source: https://lbs.amap.com/api/webservice/guide/api/traffic-incident 查询授权城市内的交通事件信息，包括事故、施工、管制等。HTTP GET 方法，不支持 JSONP/callback 参数。 ```APIDOC ## [GET] https://et-api.amap.com/event/queryByAdcode ### Description 获取授权城市有效交通事件，包括事故、施工、管制等信息。 ### Method GET ### Endpoint https://et-api.amap.com/event/queryByAdcode ### Parameters #### Query Parameters - **adcode** (string) - Required - 授权城市 ADCODE（城市级） - **clientKey** (string) - Required - 用户在高德开放平台官网申请的 Web 服务 API 类型 KEY - **timestamp** (string) - Required - 秒时间，例如1621243952 单位秒 - **digest** (string) - Required - 根据授权密钥计算出的动态鉴权信息 - **eventType** (string) - Required - 仅获取对应类型事件，多个;分割 - **isExpressway** (string) - Required - 仅获取高速类事件。1-是 0-否 ### Request Example GET https://et-api.amap.com/event/queryByAdcode?adcode=110000&clientKey=YOUR_KEY×tamp=1621243952&digest=YOUR_DIGEST&eventType=201;202&isExpressway=0 ### Response #### Success Response (200) 返回结果为JSON格式，包含： - **code** (number) - 调用成功，常见代码：0：Successful. 成功 - **msg** (string) - 调用成功信息 - **data** (array) - 事件列表，每个事件包含： - **brief** (string) - 事件标题 - **endTime** (string) - 事件预计结束时间 - **eventDesc** (string) - 事件描述 - **eventID** (string) - 事件id - **eventType** (string) - 事件类型码 - **expressway** (string) - 是否高速1-是0-否 - **lines** (string) - 线路坐标 - **nickName** (string) - 发布方名称 - **offcial** (string) - 是否权威发布0-官方1-权威2-UGC - **picture** (string) - 事件图片链接 - **roadName** (string) - 道路名称 - **source** (string) - 数据源编号 - **startTime** (string) - 事件开始时间 - **updateTime** (string) - 事件最后更新时间 - **x** (string) - 经度坐标 - **y** (string) - 纬度坐标 #### Response Example ```json { "code": 1, "data": [ { "brief": "张河高速服务区附近南向北正在施工。", "endTime": "2018-05-13 8:11:0", "eventDesc": "张河高速施工：张河高速南向北施工，2018年04月28日08:11到2018年05月13日08:11", "eventID": 5366913, "eventType": 201, "expressway": 1, "lines": "102.0647958,35.6291286;102.0652033,35.6301692;102.0665325,35.6332136", "nickName": "高德交通", "offcial": 1, "picture": "", "roadName": "张河高速", "source": 262, "startTime": "2018-04-28 8:11:0", "updateTime": "2018-05-07 22:47:18", "x": 102.0648, "y": 35.62913 }] } ``` ``` -------------------------------- ### GET /v3/weather/weatherInfo Source: https://lbs.amap.com/api/webservice/guide/api/weatherinfo 天气查询接口，根据城市编码（adcode）查询目标区域的实况天气或预报天气。请求方式为 GET，返回格式支持 JSON 或 XML。 ```APIDOC ## [GET] /v3/weather/weatherInfo ### Description 天气查询接口，根据城市编码（adcode）查询目标区域的实况天气或预报天气。 ### Method GET ### Endpoint https://restapi.amap.com/v3/weather/weatherInfo ### Parameters #### Query Parameters - **key** (string) - Required - 请求服务权限标识，用户在高德地图官网申请的 Web 服务 API 类型 KEY。 - **city** (string) - Required - 城市编码，输入城市的 adcode，adcode 信息可参考城市编码表。 - **extensions** (string) - Optional - 气象类型，可选值：base（返回实况天气）、all（返回预报天气）。 - **output** (string) - Optional - 返回格式，可选值：JSON、XML，缺省值为 JSON。 ### Request Example https://restapi.amap.com/v3/weather/weatherInfo?city=110101&key=<用户key> ### Response #### Success Response (200) - **status** (string) - 返回状态，值为0或1，1：成功；0：失败。 - **count** (string) - 返回结果总数目。 - **info** (string) - 返回的状态信息。 - **infocode** (string) - 返回状态说明，10000代表正确。 - **lives** (object) - 实况天气数据信息。 - **province** (string) - 省份名。 - **city** (string) - 城市名。 - **adcode** (string) - 区域编码。 - **weather** (string) - 天气现象（汉字描述）。 - **temperature** (string) - 实时气温，单位：摄氏度。 - **winddirection** (string) - 风向描述。 - **windpower** (string) - 风力级别，单位：级。 - **humidity** (string) - 空气湿度。 - **reporttime** (string) - 数据发布的时间。 - **forecast** (object) - 预报天气信息数据。 - **city** (string) - 城市名称。 - **adcode** (string) - 城市编码。 - **province** (string) - 省份名称。 - **reporttime** (string) - 预报发布时间。 - **casts** (array) - 预报数据 list 结构，元素 cast，按顺序为当天、第二天、第三天的预报数据。 - **date** (string) - 日期。 - **week** (string) - 星期几。 - **dayweather** (string) - 白天天气现象。 - **nightweather** (string) - 晚上天气现象。 - **daytemp** (string) - 白天温度。 - **nighttemp** (string) - 晚上温度。 - **daywind** (string) - 白天风向。 - **nightwind** (string) - 晚上风向。 - **daypower** (string) - 白天风力。 - **nightpower** (string) - 晚上风力。 #### Response Example { "status": "1", "count": "1", "info": "OK", "infocode": "10000", "lives": { "province": "北京市", "city": "北京市", "adcode": "110101", "weather": "晴", "temperature": "15", "winddirection": "东南", "windpower": "2", "humidity": "30", "reporttime": "2025-03-18 12:00:00" }, "forecast": { "city": "北京市", "adcode": "110101", "province": "北京市", "reporttime": "2025-03-18 11:00:00", "casts": [ { "date": "2025-03-18", "week": "2", "dayweather": "晴", "nightweather": "晴", "daytemp": "18", "nighttemp": "5", "daywind": "东南", "nightwind": "东南", "daypower": "2", "nightpower": "2" } ] } } ```