ak

string

开发者密钥

是

guid

string

设备id

否

kw

string

关键字

是

若搜索的词语在当前城市无结果，且城市分布中无出类拔萃的结果，则返回省份列表信息；
若搜索的关键字与城市的关系非常紧密，则进行城市跳转后搜索；
若搜索的关键字在城市分布中具有出类拔萃的城市，因而进行城市跳转后搜索

city

string

查询城市

是

搜索行政区域的adcode/名称，示例“北京市”

lonlat

string

当前位置经纬度

否

如果该字段值为空，则获取当前城市中心点

exinfo

int

返回poi信息控制

否

1

默认1，取值范围：1：返回基本信息；2：返回POI详细信息 3：返回POI详细信息，但不返回子POI信息

sort

string

排序

否

取值范围：(POI类型)
（该字段需使用”UTF-8”进行URL编码）
公有排序：
default|ASC（默认排序）;
dis|ASC（距离升序）；
rank|ASC（星级升序）；
rank|DESC（星级降序）；
餐饮特有排序：
envi|DESC（环境降序）;
service|DESC(服务降序);
taste|DESC（口味降序）;
price|ASC(价格升序)；
price|DESC（价格降序）；
加油站特有排序：
price|ASC(价格升序)；
price|DESC（价格降序）

psize

int

每页记录数

否

15

默认15，小于1按1处理，大于15按15处理

pnum

int

当前页

否

1

默认返回第1页，小于1按1处理，大于20按20处理

inGb

string

输入的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
g84：GPS设备获取的坐标
gbd：百度坐标

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

language

string

语言类型

否

默认：ch
ch: 中文
en：英文

status

int

返回状态

详情参照状态码表

msg

string

返回状态描述

详情参照状态码表

data

object

返回的结果

total

int

检索的结果总数

ftype

string

获取筛选排序配置信息的标识

默认：0
0：公共类型
10：餐饮类型
11：汽车类型
27：停车场类型
28：加油站类型
33：充电站类型

provs

array

返回省份分布结果列表

pnm

string

省份名字

lonlat

string

中心点经纬度

省级行政区域的中心点（是指整个省的行政区域中心点），经度和纬度用","分隔

adcode

string

省份的区域编码

num

int

省份的分布数量

count

int

省份下的城市数量

cities

array

省份下的城市分布结果列表

cnm

string

城市名称

lonlat

string

中心点经纬度

城市中心点（是指城区的中心点），经度和纬度用","分隔

adcode

string

该城市的adcode

6位国标码

num

int

总数

该城市包含此关键字的个数

pois

array

返回的POI信息列表

pid

string

poi唯一ID

可用于地点详情检索

nm

string

poi名称

snm

string

Poi名称简称

子poi信息才会返回值

lonlat

string

poi经纬度

nlonlat

string

导航经纬度

用于导航，经度和纬度用“,”分隔

addr

string

poi地址信息

prov

string

所属省份

city

string

所属城市

dist

string

所属区县

phone

string

该POI的电话

tp

string

所属类型名称

tcode

string

所属类型编码

dis

string

离中心点距离

brand

string

品牌

tag

string

标签

标签，多个标签之间用","分隔，
示例：5A级景区,文物古迹

photo

string

图片URL列表，多张图片之间用”;”分隔

rinfo

string

简介

extend

object

poi的扩展信息

仅当exinfo=2或3时，显示该字段，不同的poi类型，显示的内容不一样

price

string

poi商户价格

取值范围：
餐饮相关poi：返回人均价
停车场相关poi：返回时间段收费信息
加油站相关poi：返回油价信息（油价，油价由油号和价格组成，油号与价格之间用":"分隔，多个油价之间用","分隔）
充电站相关poi：返回充电收费信息
酒店相关poi：显示酒店订购起价

taste

string

口味

service

string

服务

取值范围：
加油站相关poi：1表示便利店、2表示洗车、3表示汽车修理、4表示卫生间、5表示餐饮、6表示住宿、7表示换油、8表示自助加油、11表示换油（港澳）、12表示洗车（港澳）、13表示便利店（港澳）、14表示卫生间（港澳），多个服务之间用"|"分隔.
餐饮相关poi： 服务评分

envi

string

环境

score

float

评分

time

string

营业时间

faci

string

设施

多个之间用逗号分隔，建议最多3个。示例："1,2,3,5"
1：免费wifi
2：收费wifi
3：免费宽带
4：收费宽带
5：免费停车场
6：收费停车场
7：免费接机服务
8：收费接机服务
9：室内游泳池
10：室外游泳池
11：健身房
12：商务中心
13：会议室
14：酒店餐厅
15：叫醒服务
16：行李寄存
17：双床
18：大床

rank

string

星级

艺龙酒店类特有说明，当返回值为0时艺龙酒店对外显示可用reco的值，但请进行图标区分

reco

string

cp推荐信息

取值范围：
艺龙酒店类：（返回艺龙内部推荐星级：客栈、舒适、高档、豪华、公寓）
餐饮类：返回推荐菜
（仅艺龙酒店和美食相关poi返回）

cpid

string

合作方id

合作方数据，按tcode进行数据融合

cpnm

string

合作方名字

合作方数据，按tcode进行数据融合
(完成企业认证后，才能开通权限)

cpurl

string

合作方官方网址

status

int

停车场或加油站状态

和tcode配合使用：
tcode=停车场编码（0表示车位关闭、1表示车位充足、2表示车位够用、3表示车位较少、4表示车位紧张、5表示车位未知）
tcode=加油站编码（0表示未知，1表示正常营业， 2表示暂停营业，3表示停业关闭，4表示未核实，-1表示空）
tcode=充电站编码（0：未知
1：建设中
5：关闭下线
6：维护中
50：正常使用）
（仅停车场，加油站和充电站相关poi返回）
(完成企业认证后，才能开通权限)

total

int

车位总数

和tcode配合使用：
tcode=停车场编码，显示总车位数（返回值0，表示未知）
tcode=充电站编码，显示充电桩数量（返回值0，表示未知）
（仅停车场和充电站相关poi返回）
(完成企业认证后，才能开通权限)

sfree

int

空车位数

（仅停车场相关poi返回，返回值为-1，表示未知）
(完成企业认证后，才能开通权限)

model

int

充电站类别

1表示标准充电、2表示中速充电、3表示快速充电，多个充电器类别之间用"|"分隔（该字段已废弃，建议使用sinfo字段）
（仅充电站相关poi返回）
(完成企业认证后，才能开通权限)

payment

string

支付方式

tcode=停车场、加油站、充电桩类型时有效

zcode

string

邮编

tcode=汽车类型时有效

ebnum

int

换电箱数量

tcode=充电站类型时有效

ptype

string

插头规格

插头规格（港澳），11表示3孔家用、12表示7孔欧式单相电、21表示7孔欧式三相电、22表示5孔美式、23表示3孔家用、31表示日本CHAdeMO标准插头，多个插头规格之间用"|"分隔
tcode=充电站类型有效

parknum

string

电动车停车泊位号

tcode=充电站类型时有效

fee

string

收费标准

tcode=停车场类型时有效

ftext

string

收费信息

tcode=停车场类型时有效

tollway

string

收费方式

tcode=停车场类型时有效

ports

array

停车场出入口列表

tcode=停车场类型时有效

dir

string

出入口方向

lonlat

string

经纬度坐标

经度和纬度用","分隔

type

int

出入口类型

0 表示入口、1 表示出口、2 表示出入口

sinfo

array

充电桩设备列表

tcode=充电站类型有效

etype

int

设备类型

1：直流设备
2：交流设备
3：交直流一体设备
4：无线设备
5：其他

ctotal

int

充电桩总数

cftotal

int

充电桩空闲数

childrens

array

子POI信息列表

若poi无子点，该字段为空

tag

object

子poi标签信息

tnm

string

标签名称

pois

array

子poi信息列表

dist

object

行政区域切换信息

（搜索结果为城市跳转返回该信息）

parents

string

父行政区名称列表

多个名称之间用”|”分隔

nm

string

名称

adcode

string

区域编码

lv

int

行政区域级别

0：国家、1：省、2：市、3：县

lonlat

string

行政区域中心点

（市级行政区的中心点是城区的中心点），经度和纬度用","分隔

lonlats

行政区域边界

所属省份

目前只返回最东、最南、最西、最北4个点的经纬度，格式：最东经度,最东纬度;最南经度,最南纬度;最西经度,最西纬度;最北经度,最北纬度

ak

string

开发者密钥

是

guid

string

设备id

否

kw

string

关键字

是

city

string

查询城市

是

搜索行政区域的adcode/名称，示例“北京市”

exinfo

int

返回poi信息控制

否

1

默认1，取值范围：
1：返回基本信息；
2：返回POI详细信息
3：返回POI详细信息，但不返回子POI信息

lonlat

string

当前位置坐标

是

格式：经度,纬度

radius

int

检索半径

否

3000

单位：米，取值范围:0-50000。规则：大于50000按默认值，默认：3000

sort

string

排序

否

取值范围：(POI类型)
（该字段需使用”UTF-8”进行URL编码）
公有排序：
default|ASC（默认排序）
dis|ASC（距离升序）
rank|ASC（星级升序）
rank|DESC（星级降序）
餐饮特有排序：
envi|DESC（环境降序）
service|DESC(服务降序)
taste|DESC（口味降序）
price|ASC(价格升序)
price|DESC（价格降序）
加油站特有排序：
price|ASC(价格升序)
price|DESC（价格降序）

inGb

string

输入的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
g84：GPS设备获取的坐标
gbd：百度坐标

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

psize

int

每页记录数

否

15

默认15，小于1按1处理，大于15按15处理

pnum

int

当前页

否

1

默认返回第1页，小于1按1处理，大于20按20处理

language

string

语言类型

否

默认：ch
ch: 中文
en：英文

ak

string

开发者密钥

是

guid

string

设备id

否

kw

string

关键字

是

city

string

查询城市

是

搜索行政区域的adcode/名称，示例“北京市”

exinfo

int

返回poi信息控制

否

1

默认1，取值范围：
1：返回基本信息；
2：返回POI详细信息
3：返回POI详细信息，但不返回子POI信息

lonlats

string

矩形坐标串

是

规则：经度和纬度用","分隔，坐标对用";"分隔。传入左上右下两顶点坐标对

sort

string

排序

否

取值范围：(POI类型)
（该字段需使用”UTF-8”进行URL编码）
default|ASC（默认排序）
dis|ASC（距离升序）
rank|ASC（星级升序）
rank|DESC（星级降序）

inGb

string

输入的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
g84：GPS设备获取的坐标
gbd：百度坐标

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

psize

int

每页记录数

否

15

默认15，小于1按1处理，大于15按15处理

pnum

int

当前页

否

1

默认返回第1页，小于1按1处理，大于20按20处理

language

string

语言类型

否

默认：ch
ch: 中文
en：英文

ak

string

开发者密钥

是

guid

string

设备id

否

kw

string

关键字

是

lonlats

string

多边形坐标串

是

规则：经度和纬度用","分隔，坐标对用";"分隔。经纬度至少2对以上

city

string

查询城市

是

搜索行政区域的adcode/名称，示例“北京市”

sort

string

排序

否

取值范围：(POI类型)
（该字段需使用”UTF-8”进行URL编码）
default|ASC（默认排序）
dis|ASC（距离升序）
rank|ASC（星级升序）
rank|DESC（星级降序）

exinfo

int

返回poi信息控制

否

1

默认1，取值范围：
1：返回基本信息；
2：返回POI详细信息
3：返回POI详细信息，但不返回子POI信息

limit

int

路线长度

否

20000

单位是米，默认20000米，当lonlats参数所指定的线路长度大于该参数时，以起点开始截取该参数所指定的线路长度进行沿线路搜索，小于1按20000处理，大于20000按20000处理

radius

int

搜索半径

否

单位：米，取值范围:1-10000。默认3000米

inGb

string

输入的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
g84：GPS设备获取的坐标
gbd：百度坐标

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

psize

int

每页记录数

否

15

默认15，小于1按1处理，大于15按15处理

pnum

int

当前页

否

1

默认返回第1页，小于1按1处理，大于20按20处理

language

string

语言类型

否

默认：ch
ch: 中文
en：英文

ak

string

开发者密钥

是

guid

string

设备id

否

id

string

POI唯一id

是

exinfo

int

返回poi信息控制

否

1

默认1，取值范围：
1：返回基本信息；
2：返回POI详细信息
3：返回POI详细信息，但不返回子POI信息

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

language

string

语言类型

否

默认：ch
ch: 中文
en：英文

ak

string

开发者密钥

是

guid

string

设备id

否

cpid

string

cp唯一标识

是

cpnm

string

cp名称

是

adate

string

入住日期

否

大于等于昨天。如果入住的时间为凌晨，那么传入前一天的日期。格式：yyyy-MM-dd示例：2018-11-18（酒店信息查询专用字段） 默认值

ddate

string

离店日期

否

至少晚于到店时间1天，不多于30天，格式：yyyy-MM-dd示例：2017-11-19（酒店信息查询专用字段） 默认值

exinfo

int

返回信息控制

否

1

默认1，取值范围：
1：返回基本信息；
2：返回POI详细信息

outGb

string

输出的坐标系

否

g02

默认：g02，
g02：国测局（gcj02）坐标
gbd：百度坐标

status

int

返回状态

详情参照状态码表

msg

string

返回状态描述

详情参照状态码表

data

object

返回的结果

cpid

string

cp唯一ID

cpnm

string

cp名称

lonlat

string

经纬度

addr

string

地址信息

city

string

所属城市

phone

string

电话

otime

string

营业时间

type

string

cp

返回值说明： hotel：酒店、cater：美食、scenery：景点、parking：停车场、charge:充电站、gas：加油站（暂时不支持）

rinfo

string

cp简介

rimgurl

int

cp封面图

faci

string

设施

仅酒店和美食有数据返回

rec

array

cp推荐信息

type=scenery，返回购票须知（仅景点有数据返回）

rimgurls

array

cp图片集

最多5个

extend

object

cp的扩展信息

仅当exinfo =2时，显示该字段，不同的cp类型，显示的内容不一样

detail

cp扩展信息

cp扩展信息的具体字段，参见下面的文档
酒店：hotelinfo
美食：caterinfo
景点：sceinfo
停车场：parking
充电站：charge
加油站：gas（暂时不支持）

deals

array

团购信息列表

id

string

团购id

name

string

团购名称

oprice

float

原价

price

float

团购价格

stime

string

开始时间

etime

string

结束时间

snums

int

销量

score

string

评分

0-5分，精度0.1

link

string

pc前端页面

cp下单页面

comment

array

评论信息

最多5条

tating

int

评分

取值范围0-50，除以10转成评分

content

string

内容

time

long

时间戳

imgurls

string

评论图片

最多5个，多张图片之间用";"间隔

rooms

array

房型列表

rid

string

展示房型编号

rnm

string

房型名称

picurl

string

房型封面图片

房型封面图片url地址

area

string

面积

btype

string

床型

floor

string

楼层

bnet

string

上网情况

0-无
1-免费宽带
2-收费宽带
3-免费WIFI
4-收费WIFI

capcity

string

可容纳人数

床位房购买的为床位，与此处的入住人数无关。

imgurls

array

房型图片集

最多5个

pros

array

产品信息列表

pid

int

产品编号

pnm

string

产品名称

price

double

日均价

isbf

string

是否含有早餐

true：含早
flase：无早

ptype

string

付款类型

SelfPay-担保、Prepay-预付

pdesc

string

付款类型描述

link

string

下单地址

cp下单页面url

review

object

评价

good

int

好评数

poor

int

差评数

count

int

评论总数

score

string

好评率

0-5分，精度0.1

policys

array

价格列表

id

int

价格策略id

nm

string

价格策略名称

putil

int

产品单元

putilnm

string

产品单元名称

price

double

门市价格

单位：元

tcprice

double

同城价格

单位：元

ptype

int

付款类型

支付方式 0：景区现付 1：在线支付 3：其他支付

time

string

提前预定时间

格式:HH:mm

gmode

string

入园方式

cltems

string

景区包含项目

remark

string

预定说明

SelfPay-担保、Prepay-预付

indesc

string

发票说明

rerule

string

退票说明

link

string

下单地址

预订跳转

status

string

停车场当前繁忙状态

空/忙/满/关

total

int

总车位数

返回值为-1时，表示无数据返回

sfree

int

空闲车位数

返回值为-1时，表示无数据返回

fee

string

标准收费

feew

string

双休日标准收费

feeh

string

节假日标准收费

pay

string

收费方式

POS机/银联卡/支付宝二维码/微信二维码/闪付二维码/手机应用/缴费机

plink

string

支付链接

可还原为二维码

feep

float

下一个小时预测收费标准

feelv

int

标准收费高低

0：未知；1：低价；2：中价；3：高价

feex

int

优惠收费高低

0：未知；1：低价；2：中价；3：高价

diff

int

停车难易度

0：未知；1：容易；2：普通；3：困难

recom

int

停车场综合推荐度

0：未知；1：推荐；2：普通；3：不推荐

ports

array

停车场出入口列表

nm

string

出入口名称

示例：北清路

lonlats

string

出入口坐标串

格式为”经度1,纬度1; 经度2,纬度2….”

type

string

出入口类型

0表示入口、1表示出口、2表示出入口

stype

string

充电站点类型

1：公共
50：个人
100：公交（专用）
101：环卫（专用）
102：物流（专用）
103：出租车（专用）
255：其他

status

int

充电站状态

0：未知
1：建设中
5：关闭下线
6：维护中
50：正常使用

pnums

int

可停放充电车位总数

cons

int

建筑物

1：居民区
2：公共机构
3：企事业单位
4：写字楼
5：工业园区
6：交通枢纽
7：大型文体设施
8：城市绿地
9：大型建筑配建停车场
10：路边停车位
11：城际高速服务区
12：其他

mcars

string

描述该站点接受的车大小以及类型

如大巴、物流车、私家乘用车、出租车等

efee

string

电费

cfree

int

是否免费

0： 免费
1：不免费
2：未知

sfee

string

充电服务费

pfee

string

停车费用

pfree

int

是否免费停车

0： 免费
1：不免费
2：未知

pay

string

支付方式

recom

int

推荐站

默认值：2
0： 推荐
1：不推荐
2：无建议

sorder

int

是否支持预约

默认值：0
0： 不支持
1：支持

einfos

array

设备信息列表

eid

string

设备唯一编码

egun

int

是否带充电枪

默认值：2
0：有充电枪
1：无充电枪
2：未调查

etype

int

设备类型

1：直流设备
2：交流设备
3：交直流一体设备
4：无线设备
5：其他

lonlat

string

设备经纬度

power

int

功率

ename

string

充电设备接口名称

cinfos

array

充电设备信息列表

cid

string

充电设备接口编码

cname

string

充电设备接口名称

ctype

int

插口类型

1：家用插座(模式2）
2：交流接口插座（模式3，连接方式B）
3：交流接口插头（带枪线，连接方式C）
4：直流接口枪头（带枪线，模 式4）
5：无线充电座
6：其他

vulimits

int

最高电压，单位:V

vllimits

int

最低电压，单位:V

current

int

充电电流

power

int

功率

status

int

桩状态

0：离网
1：空闲
2：占用（未充电）
3：占用（充电中）
4：占用（预约锁定）
255：故障

parkno

string

停车场位置编号

ak

string

开发者密钥

是

guid

string

设备id

否

ftype

string

数据类型

是

目前只支持如下类型：
10：餐饮类型
11：汽车类型
27：停车场类型
28：加油站类型

status

int

返回状态

详情参照状态码表

msg

string

返回状态描述

详情参照状态码表

data

object

返回的结果

total

int

配置项的数量

configs

array

配置项列表

nm

string

配置项名称

范围筛选、类型/品牌筛选、排序选择

pnm

string

配置项对应搜索方式名称

取值范围：
筛选范围：range，
类型或品牌关键字搜：kws，
排序选择：sort。

content

array

配置项内容

detail

string

配置项内容详细信息

code

string

类型编码

nm

string

类型名称

categories

array

子类列表

数据结构和父类一致

nm

string

类型名称

value

string

类型值

isdef

int

是否是默认值

1：默认值，0：非默认