携程获取景点详情 API 返回值说明

简介: 随着旅游业的不断发展,在线旅游服务平台如携程提供了丰富的API接口,以方便开发者获取各类旅游信息。其中,获取景点详情的API是非常实用的一个功能,它能够为用户提供详尽的景点信息。本文将详细阐述通过携程获取景点详情API返回的数据字段及其含义。


1. 景点名称(name)

此字段返回的是景点的官方名称,它是对用户展示的最直接信息,通常用于列表页或搜索结果中。

2. 景点地址(address)

这一字段提供了景点的具体位置信息,包括省、市、区以及具体的街道或乡村等级别,有助于用户规划行程。

3. 景点介绍(introduction)

这部分内容是关于景点的简介,可能包括历史背景、文化价值、特色亮点等信息,帮助用户了解景点的重要性和特色。

4. 开放时间(opening_hours)

这个字段说明了景点的开放时间,通常会区分工作日和节假日,甚至特殊日期的开放时间,这对于用户安排访问计划至关重要。

5. 门票价格(ticket_prices)

门票价格字段会列出不同类型门票的价格,比如成人票、儿童票、学生票等,有时还会包括优惠信息或电子票务相关的说明。

6. 交通指南(transportation)

交通指南为用户提供了到达景点的不同交通方式,包括公共交通(地铁、公交、火车等)和自驾路线,以及从主要地点出发的大致时间和距离。

7. 周边设施(nearby_facilities)

周边设施字段介绍了景点附近的其他服务设施,例如餐饮、住宿、购物等,这可以帮助用户了解景区的综合服务能力。

8. 注意事项(notes)

注意事项一般包含游客在参观时需要遵守的规则,如安全须知、禁止携带的物品、最佳游览路线建议等,确保游客的参观体验和安全。

9. 图片列表(image_list)

图片列表为用户展示了景点的实景照片,这些图片可能包括景区的外观、内部景观、特色活动等,极大地丰富了用户的视觉体验。

综上所述,携程的景点详情API返回值覆盖了用户在规划旅行时所需的大部分信息。通过这些详细的数据字段,用户可以快速地了解目的地情况,进而做出更加合理的行程安排。开发者在接入此类API时,应确保能够正确解析并展示这些信息,以提供给用户最佳的服务体验。

二、API介绍

前往测试

名称

类型

必须

描述

key

String

调用key(必须以GET方式拼接在URL中)

secret

String

调用密钥

api_name

String

API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]

cache

String

[yes,no]默认yes,将调用缓存的数据,速度比较快

result_type

String

[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读

lang

String

[cn,en,ru]翻译语言,默认cn简体中文

version

String

API版本

请求参数

请求参数:num_iid=138153

参数说明:num_iid:景点id,

响应参数

Version: Date:2024-01-21

名称

类型

必须

示例值

描述

item

item[]

0


携程旅行景点详情数据

address

Str

0


景点地址

area_id

Str

0


区域ID

desc

Str

0


景点描述

desc_img

Str

0


图片描述

detail_url

Str

0


详细地址

hot

Str

0


景点热度

item_imgs

Str

0


景点主图列表

level

Str

0


景区等级

open_time

Str

0


景点开放时间

poiid

Str

0


获取评论ID

ranking

Str

0


景点排名

reviews_num

Int

0


评论总数

score

Int

0


景点评分

service

Str

0


服务政策

telephone

Str

0


景点电话

tips

Str

0


提示信息

title

Str

0


景点标题

upgrade

Str

0


优待政策

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/xiecheng/item_get_scenic/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=138153"

响应示例

{
    "item":{
        "address":"新余市渝水区西南郊16公里处仙女湖风景区",
        "area_id":"xinyu878",
        "desc":"仙女湖景区位于江西省新余市西南郊16公里处,以“情爱圣地、群岛峡谷曲水、水下千年古城、亚热带植物基因库”四绝著称。景区面积198平方公里,其中水域面积50平方公里,由舞龙湖景区、钟山峡景区和钤阳湖景区三部分组成,穿插交错着99座岛屿星罗棋布,60多条湖湾扑朔迷离。舞龙湖景区作为仙女湖景区的主景区,涵盖龙凤苑、民俗风情园、爱情岛、龙王岛、圣集寺、名人岛、桃花岛等景点。走进仙女湖,你会惊叹:此景只应天上有,人间难得几处觅!仙女湖,感觉永如初心相见,成就了一段人仙相恋的千年传奇。东晋文学家干宝所著古籍《搜神记》里,毛衣仙女在此下凡,演绎出毛衣女与檀郎的爱情故事。这里,也因此成为了人间的情爱圣地,情山爱水向你诉说别离苦、相见欢。仙女湖因此也成为了“中国七仙女传说之乡”和 “中国七夕情人节”的发祥地。一、玩在仙女湖七夕老街七夕老街位于仙女湖码头片区中心地带,整个街区从整体布局到具体的景观、建筑、交通组织、产业落位都体现着创新的思想,以注重游客体验为核心,强调精致化、品质化与主题化。街区由徽派特色马头墙、仿古外立面门窗、回廊、商业街景观亭台楼阁等建筑组成,更好的展示仙女湖的人文风貌,给游客美好难忘的游玩体验。七夕老街融合新余民宿特色、民俗娱乐、民俗活动、本地特色小吃为一体,酒楼、客栈、酒吧、茶楼、戏台点缀其间,是集游客服务、观光娱乐、美食购物、度假休闲等功能为一体,以体验闲生活、慢生活、新生活的古风情的商业特色休闲街区。2021年,七夕老街荣获江西省省级旅游休闲街区。天工开物园天工开物园位于仙女湖沁庐度假酒店旁,紧邻七夕老街、七夕演艺中心,总建筑面积约1250㎡,主要是两层设计,商铺总计46间,由钢结构集装箱打造,风格时尚、鲜明、独特。天工开物园整体定位为商业休闲街区,由儿童互动娱乐区、酒吧餐饮区、文创轻食区三部分组成,目标人群以年轻人、情侣及小家庭为主。天工开物园的出现将为所有游客提供时尚休闲、互动娱乐、亲子游玩的高沉浸性、互动性新体验。七仙女渔乐园七仙女渔乐园是一个水上休闲渔趣乐园,具有赏鱼观光、人鱼互动、趣味捕鱼、垂钓、露天野营等休闲娱乐服务,并具备承接各类垂钓赛事及各类户外拓展活动的功能。园内有各式观赏鱼:色彩艳丽的锦鲤鱼、形态奇异的鸭嘴鱼、来势凶猛的黄金鱼群等。惊险刺激的人鱼互动项目有:浑水摸鱼、赤脚渡河、奶瓶喂鱼、当一日渔民等;趣味十足的水上运动有:水上激光碰碰船、特战船、皮划艇、浆板等。游客通过游玩观光,不但领略了仙女湖自然生态景观,饱览了各式各样的鱼类,更能体验水上运动的惊险刺激,让您成为仙女湖的主人,实现了一场忘我的旅行。七夕演艺中心七夕演艺中心矗立在仙女湖码头广场,依托于央视七夕晚会而打造的长期性演艺场馆。舞台以仙女下凡的爱情传说故事为设计主题,以半球形钢架结构建筑,融合地球和天堂、凡间与仙界的爱情元素,在充分展示仙女湖爱情文化的同时,也增加了景区建筑物的美感。七夕演艺中心是仙女湖一个具有重要意义的标志性的艺术性建筑,舞台结构一半拱门,一半倒影,形成一个完整的圆,代表充实,只有他们在一起,才能成为一个整体。舞台通过变幻莫测的五彩灯光、宛如天籁的缥缈音乐、返朴归真的造景和清新隽永的舞美,力图为观众打造一场梦幻般的视觉盛宴,形成一台气势恢宏的山水实景演出。仙女湖汽车影院仙女湖汽车影院坐落在仙女湖沁庐度假酒店西侧的停车场内。在这里你可以享受不被打扰的私人观影空间,坐在车内就可以获得自由的观影。仙幻爱情艺术馆仙幻爱情艺术馆位于仙女湖七夕老街鹊桥旁,场馆建设依托仙女湖“羽人传说”的特色文化,通过集成25个互动体验场景,以“仙幻美拍、情感体验、爱的启迪”为主题,与教育、艺术开发相结合,给游客娱乐打卡带来全新体验。二、游在仙女湖圣集寺圣集寺由叫佛教文化博览园,位于仙女湖钟山峡南岸的仙人台处,是由五台山佛教协会会长妙江大和尚亲自开山主持的一处佛教道场,因此延续了五台山佛教名山的历史文化脉络。圣集寺占地约2500亩,主峰高度432米,由圣集寺、文殊道场、观音道场、梅庵、禅园、佛教文化广场、禅修区、汉式佛塔、藏式白塔等组成。寺内有天.王殿,祈殿,雷音宝殿和藏经楼四个大殿。殿内分别供奉着大肚弥勒菩萨,韦驮菩萨,药师佛,日光菩萨,月光菩萨以及毗卢遮那佛等。圣集寺三面环山,一面临湖,山脉首尾相连,势若游龙,从东部望去,恍如“雄狮踏云”而来,是仙女湖的一块佛门净地。龙凤苑龙凤苑南北似腾飞的龙,东西象展翅的凤,故而得名“龙凤苑”。龙凤历来都是瑞祥美好的象征,素有“龙凤呈祥”、“龙飞凤舞”等吉祥之说。游历过龙凤苑的朋友,都会多吉多福,百顺百利。龙凤苑占地116亩,密林树茂,景色宜人,景观丰富。依山傍水建有龙凤徽、九龙墀、蛇池、凤巢、龙蟠台、崇蛇坛、天鸟行空、白蛇传雕塑、鸵鸟行宫、舞龙飞船等内涵丰富的景观。民俗文化风情园民俗文化风情园是一处荟萃多民族民间艺术、民俗风情和民居建筑于一园的文化旅游景点。民俗文化风情园设有民俗大舞台,每天都有多场精彩的舞蹈,演绎仙女下凡的传说故事。游客朋友们还可以现场与我们的仙女进行互动,感受不一样的仙女湖文化。爱情岛爱情岛占地面积79920㎡,是集旅游观光、休闲娱乐、度假、会务拓展、婚纱摄影等多种功能于一体的岛屿。岛内有中式的大花轿、同心锁、姻缘井、抛绣球、洞房;西式的仿“科隆大教堂”、爱琴海、浪漫满屋、海景码头、日式风情街、欧陆风情街、宫廷水道等建筑。爱情岛以爱情文化为内涵,以传播爱情文化为理念,聚集众多的爱情文化元素,是天下有情人“爱的天堂”,是浪漫、邂逅及拍照的好地方!龙王岛龙王岛位于仙女湖湖内的中心部位,它的平面像橄榄,又似台湾宝岛;它的立面形似等腰三角形,有着比日本富士山更标准的轮廓。而从凌水崖石上看龙王岛,酷似一只神龟,它与龙王岛遥遥相望,形成了“神龟拜龙王”的神奇景观。龙王岛上也称猴岛,岛上有上百只野生的猴子,有的顽劣乖张,有的憨态可鞠,但都善察人意。您面带笑容,它则绕膝撒欢;您面含怒色,它则远遁规避。站在龙王岛顶端的龙王阁,可俯瞰仙女湖碧波荡漾、烟波浩渺的全景,大大小小的岛屿既象一颗颗镶嵌在绒毯上的绿宝石,又似一个个睡梦中的仙女。近岛远山,层峦迭嶂,茫茫苍苍,俨似一幅天然山水画。据说国画大师傅抱石先生当年和关山月合作“江山如此多娇”这幅巨作的灵感就来自于仙女湖的龙王岛。名人岛名人岛根据中国江南园林古朴典雅风格而建造,以新余古今名人为主要展示内容。全岛总面积65亩,由大小两个岛组成,从空中鸟瞰,大岛如苍龙卧波,小岛如翠珠凌水,俨然“苍龙戏珠”的天然景观。名人岛由名人植树园、名人雕塑园、抱石文化园三个园区组成。名人植树园,位于岛内醉笔堂的正前方,很多海内外名人雅士在此植树纪念。名人雕塑园挑选新余自三国吴宝鼎二年(267年)立县以来,众多进士及第者中杰出的12位名人,将其立塑像在绿树映掩之中。抱石文化园是纪念国画大师傅抱石先生的园林。园门按抱石故里——罗坊樟塘村“傅氏祠堂”的风格建造的。园前有一棵连理共生的香樟树,象征着傅抱石先生“德艺双馨”。园内傅抱石塑像是画家、雕刻家陈祖煌先生按照傅抱石当年为人民大会堂绘制《江山如此多娇》巨型油画时的神态制作而成。桃花岛这里因凡人走桃花运在此偶遇仙女,又因岛上遍布桃树而命名,以“上桃花岛行桃花大运”,“集桃文化做山水文章”为风味。桃花岛门楼由明清时代的古砖修建而成,门楼墙上的砖刻有“喻南学社”、“红德润堂”、“平恒公馆”、“新喻县城砖”等铭文,具有较高的文物研究价值。三、食在仙女湖仙遇记·生态鱼馆鱼,在中国传统文化中是富庶、繁荣的象征。逢年过节、喜庆筵席及亲朋团聚之时,餐桌上总少不了鱼肴。鱼,传达着人们对“年年有余、富贵有余”的美好愿望。仙女湖湖内鱼类丰富,一直坚持人放天养的饲养模式,主要饵料为浮游生物、底栖生物、水生植物等天然饵料,养殖用水为仙女湖的优质水源。水域环境优良,天然养殖周期长,肥美的鲜鱼深受青睐。仙遇记·生态鱼馆位于仙女湖湖畔,鱼馆沿用“七仙女”的“七文化”,经过多年实践经验,一直是取新鲜活鱼为原料,用多种烹调手法并融合新余七个地区的特色菜肴,独创一鱼七吃,让您品尝鱼汤鲜美的同时,又可以尝到鱼肉的鲜嫩口感。其菜品口感独特,老少皆宜,让人回味无穷,深得广大游客、市民的喜爱。仙遇记·生态鱼馆以品质求发展,以诚信求生存,经过几年的不懈努力,现已成为家喻户晓的特色美食餐馆。四、宿在仙女湖仙女湖沁庐度假酒店仙女湖沁庐度假酒店坐落在仙女湖湖畔,总建筑面积约1.2万㎡,客房117间,配有自助餐厅、中餐厅、休闲书吧、健身房、棋牌室、会议报告厅、会议室等。酒店以现代徽派为形,清新典雅的中式风格为内部装饰,融入江南山水与文旅度假景区优美环境中。酒店通过智慧控制系统及高环保静音空调,为来宾营造闲适惬意的休闲新生活。仙女湖沁庐度假酒店,让您远离城市的喧嚣,享受天然的舒畅。",
        "desc_img":[
        ],
        "detail_url":"https://you.ctrip.com/sight/xinyu878/138153.html",
        "english_name":"",
        "hot":"5.8",
        "item_imgs":[
            {
                "url":"https://dimg04.c-ctrip.com/images/350t0r000000hagjkB897.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/100g1f000001gr0co465B.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/350u0r000000haeflEE6C.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/35050r000000hcxrm8C3B.jpg"
            }
        ],
        "level":"4A",
        "open_time":"3/1-10/31 08:00-17:30开放;11/1-2/28 08:30-17:00开放,游船开船时间:09:20,10:10,11:00,12:00,13:00,13:40",
        "poiid":99330,
        "ranking":"新余自然风光景点榜 No.1",
        "reviews_num":950,
        "score":4.2,
        "service ":[
            {
                "name":"停车场",
                "value":"【仙女湖停车场】参考价格:¥10/次;地址:新余市渝水区西南郊16公里处仙女湖景区门楼进入右拐;库位:620;无大小车之分"
            },
            {
                "name":"园内交通",
                "value":"参考价格:收费;地址:游船码头"
            },
            {
                "name":"卫生间",
                "value":"景区内设有卫生间,在西北门北侧附近,并标有醒目的指示牌。"
            },
            {
                "name":"餐饮",
                "value":"园内设有餐厅,在东南门北侧等附近。"
            }
        ],
        "telephone":"4009158099",
        "tips":[
        ],
        "title":"仙女湖",
        "upgrade":[
            {
                "name":"新余市民",
                "value":"新余本地市民,注:五一、十一、春节期间四县居民不享受免门票优惠政策,免门票"
            }
        ]
    },
    "_ddf":"curry",
    "error":"",
    "reason":"",
    "error_code":"0000",
    "cache":0,
    "api_info":"today: max:15000 all[=++];expires:2031-01-01",
    "execution_time":"3.878",
    "server_time":"Beijing/2024-01-21 18:11:06",
    "client_ip":"127.0.0.1",
    "call_args":[
    ],
    "api_type":"xiecheng",
    "server_memory":"2.99MB",
    "last_id":false
}

异常示例

{
  "error": "item-not-found",
  "reason": "没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2023-12-15 17:44:00",
  "call_args": [],
  "api_type": "xiecheng",
  "request_id": "1ee0ffc041242"}
相关文章
|
1月前
|
数据采集 搜索推荐 API
小红书笔记详情 API 接口的开发、应用与收益
小红书(RED)作为国内领先的生活方式分享平台,汇聚了大量用户生成内容(UGC),尤其是“种草”笔记。小红书笔记详情API接口为开发者提供了获取笔记详细信息的强大工具,包括标题、内容、图片、点赞数等。通过注册开放平台账号、申请API权限并调用接口,开发者可以构建内容分析工具、笔记推荐系统、数据爬虫等应用,提升用户体验和运营效率,创造新的商业模式。本文详细介绍API的开发流程、应用场景及潜在收益,并附上Python代码示例。
224 61
|
20天前
|
数据采集 JSON API
小红书笔记详情 API 接口(小红书 API 系列)
小红书作为热门生活方式平台,拥有海量用户生成内容。通过其笔记详情接口,开发者可获取指定笔记的完整内容、作者信息及互动数据(点赞、评论、收藏数等),助力内容分析与市场调研。接口采用HTTP GET请求,需提供笔记ID,响应数据为JSON格式。注意小红书有严格反爬虫机制,建议使用代理IP并控制请求频率。
|
1月前
|
数据采集 搜索推荐 API
小红书笔记详情 API 接口:获取、应用与收益全解析
小红书(RED)是国内领先的生活方式分享平台,汇聚大量用户生成内容(UGC),尤以“种草”笔记闻名。小红书笔记详情API接口为开发者提供了获取笔记详细信息的强大工具,包括标题、内容、图片、点赞数等。通过注册开放平台账号、申请API权限并调用接口,开发者可构建内容分析工具、笔记推荐系统、数据爬虫等应用,提升用户体验和运营效率,创造新的商业模式。本文将详细介绍该API的获取、应用及潜在收益,并附上代码示例。
221 13
|
1月前
|
搜索推荐 数据挖掘 API
亚马逊详情 API 接口的开发、应用与收益
亚马逊详情API接口是亚马逊开放平台提供的强大工具,允许开发者编程获取商品的详细信息,如标题、价格、描述等。通过注册账号、申请权限并调用API,开发者可构建比价工具、推荐系统和数据分析工具等应用,提升用户体验与运营效率,创造新商业模式。本文详细介绍其开发流程、应用场景及潜在收益,并附代码示例。
55 6
|
23天前
|
JSON API 数据格式
携程网获取景点列表 API 接口(携程 API 系列)
携程作为国内知名的在线旅游服务提供商,其景点列表API对接口功能、参数和返回格式进行了详细定义。该接口可获取景点基本信息(名称、地区、开放时间等),支持条件筛选查询(如按地区、评分、价格区间等)。接口返回JSON或XML格式数据,并设有调用限制以确保系统稳定性和数据安全。虽然携程未公开免费API,开发者可通过商务合作申请权限。以下为模拟Python请求示例,展示了如何使用该接口获取景点信息。 代码示例中,通过`requests.get()`发送GET请求,设置请求参数(如地区、门票价格等)和请求头(模拟浏览器访问),并处理响应数据。实际应用需替换为真实的接口URL,并遵循携程官方文档要求。
|
23天前
|
Web App开发 JSON API
携程网地方美食品列表数据接口(携程 API 系列)
携程网作为国内领先的在线旅游服务平台,整合了丰富的美食资源。通过其地方美食品列表数据接口(假设存在),开发者可获取各地特色美食信息,如名称、菜系、评分等,并按价格、热门程度筛选。接口返回 JSON 格式数据,支持地区和筛选参数设置,且有调用频率限制。示例代码展示了如何使用 Python 的 requests 库发送请求并处理响应,模拟查询北京地区的美食。实际接口需替换为真实 URL。
|
24天前
|
数据可视化 API 开发者
淘宝/天猫获得淘宝商品详情 API 返回值说明
开发者可高效接入淘宝商品数据。若需特定场景的代码示例
|
1月前
|
API PHP 开发者
速卖通商品详情接口(速卖通API系列)
速卖通(AliExpress)是阿里巴巴旗下的跨境电商平台,提供丰富的商品数据。通过速卖通开放平台(AliExpress Open API),开发者可获取商品详情、订单管理等数据。主要功能包括商品搜索、商品详情、订单管理和数据报告。商品详情接口aliexpress.affiliate.productdetail.get用于获取商品标题、价格、图片等详细信息。开发者需注册账号并创建应用以获取App Key和App Secret,使用PHP等语言调用API。该接口支持多种请求参数和返回字段,方便集成到各类电商应用中。
|
1月前
|
JSON 前端开发 API
以项目登录接口为例-大前端之开发postman请求接口带token的请求测试-前端开发必学之一-如果要学会联调接口而不是纯写静态前端页面-这个是必学-本文以优雅草蜻蜓Q系统API为实践来演示我们如何带token请求接口-优雅草卓伊凡
以项目登录接口为例-大前端之开发postman请求接口带token的请求测试-前端开发必学之一-如果要学会联调接口而不是纯写静态前端页面-这个是必学-本文以优雅草蜻蜓Q系统API为实践来演示我们如何带token请求接口-优雅草卓伊凡
64 5
以项目登录接口为例-大前端之开发postman请求接口带token的请求测试-前端开发必学之一-如果要学会联调接口而不是纯写静态前端页面-这个是必学-本文以优雅草蜻蜓Q系统API为实践来演示我们如何带token请求接口-优雅草卓伊凡
|
8天前
|
机器学习/深度学习 JSON 算法
淘宝拍立淘按图搜索API接口系列的应用与数据解析
淘宝拍立淘按图搜索API接口是阿里巴巴旗下淘宝平台提供的一项基于图像识别技术的创新服务。以下是对该接口系列的应用与数据解析的详细分析

热门文章

最新文章