高德地图搜索服务为用户提供多种查询服务，包括关键字查询、周边查询、ID查询、多边形查询。提供团购及优惠信息，同时支持多种筛选机制，对于行业（目前支持：酒店、餐饮、影院、景点类）poi返回针对性深度信息和市场动态信息。
目前，高德地图查询服务接口为用户提供如下类型的兴趣点搜索服务：
关键字查询
周边查询
多边形查询
ID查询
示例代码：
//载入方法一
$place = apibus::init("place");
/*
//载入方法二
$api = new apibus();
$place = $api->load("place");
*/
$key = '用户Key';
//$place->amaptext($key,$keywords,$types,$offset=20,$page=1,$extensions='base',$output='json',$city=null,$filter=null,$callback=null,$src='SAE');
$ret = $place->amaptext($key,'肯德鸡','餐饮服务','SAE');
//var_dump($ret);
//$place->amaparound($key,$location,$radius=3000,$sortrule='distance',$offset=20,$page=1,$extensions='base',$output='json',$keywords=null,$types=null,$city=null,$filter=null,$callback=null,$src='SAE');
$ret = $place->amaparound($key,'16.465066,39.999541','SAE');
//var_dump($ret);
//$place->amappolygon($key,$polygon,$offset=20,$page=1,$extensions='base',$output='json',$keywords=null,$types=null,$city=null,$filter=null,$callback=null,$src='SAE')
$ret = $place->amappolygon($key,'116.460988,40.006919;116.48231,40.007381;116.47516,39.99713;116.472596,39.985227;116.45669,39.984989;116.460988,40.006919');
//var_dump($ret);
//$place->amapdetail($key,$id,$output='json',$callback=null,$src='SAE');
$ret = $place->amapdetail($key,'B00141IEZK','SAE');
var_dump($ret);
- 分类：第三方服务
- 官方网站：
http://api.amap.com
Methods
amaptext(GET)
参数
keyString
- 用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register
keywordsString
- 查询关键字。多个关键字用“|”分割
typesString
- POI分类。多个类型用“|”分割。可选值：文本分类、分类代码
offsetString
- 每页记录数据。最大每页记录数为50条。超出取值范围按默认值返回，默认值：20
pageString
- 当前页数。最大翻页数100，超出取值范围按默认值返回，默认值：1
extensionsString
- 返回结果控制。取值为：base，返回基本信息；取值为：all，返回基本+详细信息
outputString
- 返回数据格式类型，可选值：json,xml
cityString
- 查询城市。可选值：cityname（中文或中文全拼）、citycode、adcode
filterString
- 筛选条件 含义 使用方法 适用行业 groupbuy 团购 groupbuy+“:”+ 团购标识符，1代表有团购 不限行业 discount 优惠 discount+“:”+优惠标识符，1代表有优惠 不限行业 meal_ordering 订餐 meal_ordering+":"+订餐标识符，1代表可定餐 餐饮业 cost 消费均价 cost+":" +cost1(>=0)，cost2(>=cost1)，其中cost2为上限，cost1为下限，cost1必填，cost2可不填，不填代表无上限,默认该价格为不限。 不限行业 rating 整体评价 rating+":" +rating1(>=0)，rating2(>=rating1)且最大为6，为区间筛选，其中rating2为上限，rating1为下限，rating1必填，rating2可不填，不填代表无上限,默认评价值为不限范围。当rating2>6时,rating2取值6。 不限行业 star 酒店星级 star+“:”+星级（只限0，1，2，3，4，5），多个星级或逻辑用“,”隔开 酒店 支持多个筛选条件。筛选条件之间使用“|”代表或关系，只有团购（groupbuy）和优惠（discount）之间支持“或”关系；使用“+”代表与关系。设置筛选条件时，extensions必须取值为all。
callbackString
- 回调函数，callback值是用户定义的函数名称，此参数只在output=json时有效
srcString
- 新浪sdk标识，值为：SAE
返回
返回示例
status 返回结果状态值，值为0或1,0表示请求失败；1表示请求成功 count 返回结果数目。 info 返回状态说明，status为0时，info返回错误原因，否则返回“OK” suggestion 建议列表 keywords建议关键字列表 keyword 建议关键字 cities 建议城市列表 name 城市名称 citycode城市编码 adcode 区域编码 num 此区域的建议结果数目 pois poi基本信息列表 id 唯一ID name 名称 type 兴趣点类型 location经纬度 address 地址 distance离中心点距离 tel 电话 poi详细信息列表，extensions=all时返回；extensions=base时不返回 website 网址 pcode poi所在省份编码 pname poi所在省份名称 citycode城市编码 cityname城市名 adcode 区域编码 adname 区域名称 recommend 推荐标识 entr_location 入口经纬度 exit_location 出口经纬度 navi_poiid 导航点ID gridcode 地理格id match 匹配 postcode 邮编 email 电子邮箱 groupbuy_num 是否有团购，0表示无团购；1表示有团购 discount_num 是否有优惠，0表示无折扣；1表示有折扣 biz_ext 行业扩展信息，不同行业POI返回相应行业扩展字段。 meal_ordering餐饮行业，是否可订餐：0表示不可订餐；1表示可订餐 rating 餐饮行业，整体评分 cost 餐饮行业，平均消费，单位：元 star 酒店行业，表示酒店星级 lowest_price 酒店行业，酒店最低价，单位：元 seat_ordering 影院行业，是否可订座：0表示不可订座；1表示可订座。
举例：["status value","count value","info value"]错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例{"info":"info value"}
amaparound(GET)
参数
keyString
- 用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register
locationString
- 中心点坐标。经度和纬度用","分割，经度在前，纬度在后，经纬度小数点后不得超过6位。
radiusString
- 查询半径。单位：米，取值范围:0-50000。规则：大于50000按默认值，默认值：3000
sortruleString
- 排序规则。目前支持：按距离排序：distance；综合排序：weight。默认值：distance
offsetString
- 每页记录数据。最大每页记录数为50条。超出取值范围按默认值返回，默认值：20
pageString
- 当前页数。最大翻页数100，超出取值范围按默认值返回，默认值：1
extensionsString
- 返回结果控制。取值为base，返回poi基本信息；取值为all，返回基本+详细信息。默认值：base
outputString
- 返回数据格式类型，可选值：json,xml
keywordsString
- 查询关键字。多个关键字用“|”分割
typesString
- POI分类，多个类型用“|”分割。可选值：文本分类、分类代码
cityString
- 查询城市。可选值：cityname（中文或中文全拼）、citycode、adcode
filterString
- 筛选条件：支持多个筛选条件。筛选条件之间使用“|”代表或关系，只有团购（groupbuy）和优惠（discount）之间支持“或”关系；使用“+”代表与关系。设置筛选条件时，extensions必须取值为all。 具体筛选规则参见关键字查询
callbackString
- 回调函数，callback值是用户定义的函数名称，此参数只在output=json时有效
srcString
- 新浪sdk标识
返回
返回示例
返回结果字段同关键字查询
举例：["status value","count value","info value"]错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例["info value"]
amappolygon(GET)
参数
keyString
- 用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register
polygonString
- 坐标对。规则：经度和纬度用","分割，经度在前，纬度在后，坐标对用";"分割。经纬度小数点后不得超过6位。 多边形为矩形时，可传入左上右下两顶点坐标对；其他情况下首尾坐标对需相同。
offsetString
- 每页记录数据。最大每页记录数为50条。超出取值范围按默认值返回，默认值：20
pageString
- 当前页数。最大翻页数100，超出取值范围按默认值返回，默认值：1
extensionsString
- 返回结果控制。取值为：base，返回poi基本信息；取值为all，返回基本+详细信息。默认值：base
outputString
- 返回数据格式类型，可选值：json,xml
keywordsString
- 查询关键字。多个关键字用“|”分割
typesString
- POI分类。多个类型用“|”分割。可选值：文本分类、分类代码
cityString
- 查询城市。可选值：cityname（中文或中文全拼）、citycode、adcode
filterString
- 筛选条件：支持多个筛选条件。筛选条件之间使用“|”代表或关系，只有团购（groupbuy）和优惠（discount）之间支持“或”关系；使用“+”代表与关系。设置筛选条件时，extensions必须取值为all。 具体筛选规则参见关键字查询
callbackString
- 回调函数，callback值是用户定义的函数名称，此参数只在output=json时有效
srcString
- 新浪sdk标识
返回
返回示例
返回结果参见关键字查询接口
举例：["status value","count value","info value"]错误返回示例
NVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例["info value"]
amapdetail(GET)
参数
keyString
- 用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register
idString
- 兴趣点id。兴趣点的唯一标识ID
outputString
- 返回数据类型。可选值：json,xml
callbackString
- 回调函数，callback值是用户定义的函数名称，此参数只在output=json时有效
srcString
- 新浪sdk标识
返回
返回示例
status 返回结果状态值，值为0或1,0表示请求失败；1表示请求成功 count 返回结果数目。 info 返回状态说明，status为0时，info返回错误原因，否则返回“OK”。详情参阅info状态表 pois pois列表 poi poi信息列表 id 唯一ID name 名称 type 兴趣点类型 location 经纬度 address 地址 tel 电话 postcode 邮编 website 网址 email 电子邮箱 citycode 城市编码 adcode 区域编码 gridcode 地理格id distance 离中心点距离 navi_poiid 导航点ID entr_location 入口经纬度 exit_location 出口经纬度 match 匹配 recommend 推荐标识 groupbuy_num 是否有团购，0表示无团购；1表示有团购 discount_num 是否有优惠，0表示无折扣；1表示有折扣 biz_ext 行业扩展信息，不同行业POI返回相应行业扩展字段。 meal_ordering 餐饮行业，是否可订餐：0表示不可订餐；1表示可订餐 rating 餐饮行业，整体评分 cost 餐饮行业，平均消费，单位：元 star 酒店行业，表示酒店星级 lowest_price 酒店行业，酒店最低价，单位：元 seat_ordering 影院行业，是否可订座：0表示不可订座；1表示可订座。 deep_info 行业深度信息，现开放餐饮、酒店、影院poi的深度信息，其他poi不返回此列表 餐饮类poi 详见深度信息-餐饮类信息列表 酒店类poi 详见深度信息-酒店类信息列表 影院类poi 详见深度信息-影院类信息列表 景点类poi 详见深度信息-景点类信息列表 rich_content 市场动态信息 groupbuys 详见动态信息-团购动态信息 discounts 详见动态信息-优惠动态信息 review 此版本该字段为空。 roomlist 针对酒店行业，房型信息，详见动态信息-酒店动态信息 movies 详见影院动态信息 深度信息 不同行业返回深度信息不同，现支持餐饮、酒店、影院的深度信息，返回列表如下： 餐饮类信息列表 名称 说明 type 行业类型标识：dining cuisines 菜系 tag 标签 intro 简介 rating 综合评分 cp_rating 单数据源的评分 deepsrc 信息来源 taste_rating 口味评分 environment_rating环境评分 service_rating 服务评分 cost 人均消费 recommend 特色菜 atmosphere 氛围 ordering_wap_url订餐wap链接 ordering_web_url订餐web链接 orderin_app_url 订餐APP URI opentime_GDF 规范格式的营业时间 opentime 非规范格式的营业时间 addition 餐厅特色 photos 图片信息列表 photo 图片信息 title 图片名 url 图片url 酒店类信息列表 名称 说明 type 行业类型标识：hotel rating 综合评分 star 星级 intro 简介 lowest_price 最低房价 faci_rating 设施评分 health_rating 卫生评分 environment_rating环境评分 service_rating 服务评分 traffic 交通提示 addition 特色服务 deepsrc 信息来源 photos 图片信息列表 photo 图片信息 title 图片名 url 图片url 影院类信息列表 名称 说明 type 行业类型标识：cinema intro 简介 rating 综合评分 deepsrc 信息来源 is_3D 支持3D电影 parking 停车场设施 opentime_GDF 规范格式的营业时间 opentime 非规范格式的营业时间 photos 图片信息列表 photo 图片信息 title 图片名 url 图片url 景点类信息列表 名称 说明 type 行业类型标识：scenic intro 简介 rating 综合评分 deepsrc 信息来源 level 景区国标级别 price 门票价格 season 适合的游玩季节 recommend 推荐景点 theme 景区主题 order_wap_url wap购票链接 order_web_url web购票链接 opentime_GDF 规范格式的营业时间 opentime 非规范格式的营业时间 photos 图片信息列表 photo 图片信息 title 图片名 url 图片url 市场动态信息(包括团购动态信息、优惠动态信息、评论动态信息、酒店动态信息) 团购动态信息 名称 说明 groupbuy 团购信息 typecode 团购类型编码 type 团购类型 detail 详情 start_time 团购开始时间 end_time 团购结束时间 num 团购总量 sold_num 已卖出数量 original_price 原价 groupbuy_price 团购价 discount 折扣 ticket_address 取票地址 ticket_tel 取票电话 photos 图片列表 photo 图片信息 title 图片名称 url 图片地址 url 团购网址 provider 数据来源 优惠动态信息 名称 说明 discount 优惠信息 title 优惠活动标题 detail 优惠详情 start_time 优惠开始时间 end_time 优惠结束时间 sold_num 已卖出数量 photos 图片信息列表 photo 图片信息 title 图片名称 url 图片url url 优惠活动网址 provider 数据来源 评论动态信息 名称 说明 count 数目 comments 评论列表 comment 评论内容 author 作者 snippet 评论内容 recommend 作者推荐 review_time 评论时间 rating 评分 wap_url 手机端网址 app_url 手机应用网址 web_url 网页版网址 provider来源标识 酒店动态信息 名称 说明 lowest_price 最低价，单位：元 rooms 房型列表 room 房型信息 type 房型类别 name 房型名称 price 房价，单位：元 breakfast早餐供应 network 提供网络 id 客房id guarantee是否需要预订担保 tel 预订电话 ordering_wap_url wap预订链接 ordering_web_url web预订链接 src_name 房型价格来源
举例：["status value","count value","info value"]错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例["info value"]