概述

  本接口提供由文字地址到经纬度的转换能力,并同时提供结构化的省市区地址信息。

|


请求URL

        该请求为GET请求

https://apis.map.qq.com/ws/geocoder/v1/?address=

请求参数

参数 必填 说明 示例
key 开发密钥(Key) key=OB4BZ-D4W3U-XXXXX
address 需要解析的地址 200SMathildaSunyvaleCA
oversea 是否调用海外:
0 [默认]国内接口
1 海外接口
oversea=1
country 指定调用国家
(解析韩国地址时需填korea
country=Korea
postal_code 指定邮政编码 postal_code=50200
nation_code 国家代码,支持数字码和字母码 nation_code=764 nation_code=TH
language 返回结果的语言:
cn [默认]中文
local 当地语言
language=cn
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1

响应结果

名称 类型 必有 说明
status number 状态码,0为正常
message string 状态说明
result object 地址解析结果
location string 解析到的坐标,经度和纬度
lat number 纬度
lng number 经度
address string 地址
address_components object 解析后的地址描述
nation string 国家
ad_level_1 string 一级行政区划:一般为州(美国state)/县(日本)
ad_level_2 string - 二级区划,一般为郡/县(county)
ad_level_3 string - 三级区划,一般为市(city)
ad_level_4 string - 四级区划,一般为区(district)
street string - 街道
street_number string - 门牌号
ad_info object 行政区划信息
nation string 国家
nation_code string 国家代码
reliability number 可信度参考:值范围 1<低可信> - 10<高可信>

调用示例

//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/geocoder/v1?address=Daemyeong-ro,Nam-gu,Daegu,SouthKorea&key=API_KEY&oversea=1&country=korea&language=en

本页内容