GAPI. geocoding

地址API

方法列表

(static) admin(name, options, onSuccess可选, onError可选)

行政区划查询
Parameters:
Name Type Attributes Description
name String 需要查询的行政区划,如"江汉区", "武汉 江汉区"
options Object 选项
Properties
Name Type Attributes Description
parent String <optional>
查询行政区划的父级行政区划,如"湖北", "湖北 武汉", "湖北省武汉市"
onSuccess function <optional>
请求成功的回调函数
onError function <optional>
请求失败的回调函数
Returns:
Example
GAPI.geocoding.admin(
    '朝阳',
    {
        parent:'北京'
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) geocode(addr, options, onSuccess可选, onError可选)

将地址解析为坐标点
Parameters:
Name Type Attributes Description
addr String 需要解析的地址
options Object 选项
Properties
Name Type Attributes Default Description
admin String <optional>
帮助限定地址范围的行政区名称,如"北京"、"北京 海淀"、"北京市海淀区",可指定省市县行政区
limit Number <optional>
1 最多返回的结果数目,取值范围为1到100
minSimilarity Number <optional>
50 返回结果至少满足的相似度,取值范围为0到100,默认50
callAmap Object <optional>
调用第三方高德的服务
Properties
Name Type Attributes Description
uri String <optional>
高德的调用地址,默认为 restapi.amap.com/v3/geocode/geo?s=rsv3
key String <optional>
高德的JavaScript API的Key
city String <optional>
高德的城市编码,如010
onSuccess function <optional>
请求成功的回调函数
onError function <optional>
请求失败的回调函数
Returns:
Example
GAPI.geocoding.geocode(
    '丹棱街5号 微软中国研发集团总部大楼2号楼',
    {
        admin:'北京',
        limit:10,
        minSimilarity:30
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) searchNear(x, y, query, options, onSuccess可选, onError可选)

搜索一个坐标附近符合条件的地址
Parameters:
Name Type Attributes Description
x Number 经度坐标(中国带偏移)
y Number 纬度坐标(中国带偏移)
query String 搜索的关键字,如"大学"
options Object 选项
Properties
Name Type Attributes Default Description
radius Number <optional>
100 搜索半径,单位米,取值范围0到10000,默认100
limit Number <optional>
1 最多返回的结果数目,取值范围为1到100
minSimilarity Number <optional>
10 返回结果至少满足的相似度,取值范围为0到100,默认10
onSuccess function <optional>
请求成功的回调函数
onError function <optional>
请求失败的回调函数
Returns:
Example
GAPI.geocoding.searchNear(
    116.310015,
    39.991967,
    '大学',
    {
        radius:200,
        limit:10,
        minSimilarity:30
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) searchRect(xmin, ymin, xmax, ymax, query, options, onSuccess可选, onError可选)

搜索一个矩形范围内符合条件的地址
Parameters:
Name Type Attributes Description
xmin Number 最小经度坐标(中国带偏移)
ymin Number 最小纬度坐标(中国带偏移)
xmax Number 最大经度坐标(中国带偏移)
ymax Number 最大纬度坐标(中国带偏移)
query String 搜索的关键字,如"大学"
options Object 选项
Properties
Name Type Attributes Default Description
limit Number <optional>
1 最多返回的结果数目,取值范围为1到100
minSimilarity Number <optional>
10 返回结果至少满足的相似度,取值范围为0到100,默认10
onSuccess function <optional>
请求成功的回调函数
onError function <optional>
请求失败的回调函数
Returns:
Example
GAPI.geocoding.searchRect(
    116.310001,
    39.991950,
    116.321632,
    39.996899,
    '大学',
    {
        limit:10,
        minSimilarity:30
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);