马蜂窝开放平台

酒店信息查询

通过该接口可以获取与供应商酒店相似的马蜂窝酒店信息
注意：
1.响应参数中closely_score 表示相似度得分分数越高表示相似度越高
2.响应参数中name_score 和 address_score 可以作为辅助参考标准
3.如果返回的相似结果很多建议缩小请求参数中distance 的值进行更精确的匹配

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.hotel.hotel.search

请求参数

参数名称	参数类型	必填	示例	描述
zh_name	string	否	北京大酒店	酒店中文名称酒店中文名称和酒店英文名称二选一
foreign_name	string	否	capital hotel	酒店名称（英文）酒店名称和酒店英文名称二选一
zh_address	string	否	北京市	酒店地址（中文）
foreign_address	string	否	beijing	酒店地址（英文）酒店中文地址和英文地址二选一
lng	number	是	116.396426680	经度
lat	number	是	39.9041761500	纬度
distance	int	否	5	相距距离单位Km 默认5Km
number	int	否	10	每页显示多少条

响应参数

参数名称	参数类型	示例	描述
{}	object	0	马蜂窝酒店信息
└ hotel_id	int	40046	酒店ID
└ zh_name	string	北京首都大酒店	酒店中文名称
└ foreign_name	string	Capital Hotel	酒店外语名称
└ name	string	北京首都大酒店(Capital Hotel)	酒店全称
└ closely_score	number	1	相似度评分
└ mdd_id	int	10065	酒店最优先级目的地id
└ mdd_name	string	北京	酒店最优先级目的地名称
└ lat	number	39.9041761500	经度
└ lng	number	116.396426680	纬度
└ name_score	number	0.47	酒店名称相似度（1为名称完全匹配）
└ address_score	number	0.4	酒店地址相似度（1为地址完全匹配）
└ distance	int	10	相距距离（米）
└ zh_address	string	北京市	酒店中文地址
└ foreign_address	string	Yingyang East Road, Yingde	酒店外文地址

响应示例

[
    {
        "hotel_id":"40046",
        "zh_name":"北京首都大酒店",
        "foreign_name":"Capital Hotel",
        "name":"北京首都大酒店(Capital Hotel)",
        "closely_score":"1",
        "mdd_id":"10065",
        "mdd_name":"北京",
        "lat":"39.9041761500",
        "lng":"116.396426680",
        "name_score":"0.47",
        "address_score":"0.4",
        "distance":"10",
        "zh_address":"北京市",
        "foreign_address":"Yingyang East Road, Yingde"
    }
]

异常错误码

异常码	异常信息
10110777	酒店地址/酒店英文地址二者必填一
10110666	酒店名称/酒店英文名称二者必填一