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:
GAPI
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:
GAPI
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:
GAPI
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:
GAPI
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)}
);