HotelGrade

Official hotel star ratings API — 25,000+ hotels across France, Portugal & Spain from government sources

原始信息汇总

HotelGrade 数据集概述

数据集基本信息

• 数据集名称: HotelGrade
• 数据集描述: 官方酒店星级评定API，提供来自政府来源的欧洲酒店官方星级评级数据。
• 数据规模: 覆盖法国、葡萄牙和西班牙超过25,000家酒店。
• 数据来源: 直接采集自各国官方旅游管理机构的开放数据门户，无用户生成内容或网络爬取数据。

数据覆盖范围

当前覆盖国家及来源

国家	数据来源	管理机构	覆盖酒店数量
🇫🇷 法国	Atout France	旅游部 — 官方分类机构	13,000+
🇫🇷 法国	DATAtourisme	国家旅游开放数据平台	补充数据
🇵🇹 葡萄牙	Turismo de Portugal	国家旅游局 (ArcGIS注册表)	1,700+
🇪🇸 西班牙	Comunidad de Madrid	地区官方旅游登记处	500+

即将支持的国家

意大利、德国、瑞士、奥地利、希腊。

数据特性与优势

• 数据权威性: 每个星级评级均来自各国的官方国家分类机构。
• 法律效力: Atout France和Turismo de Portugal的星级评级是法律强制执行的分类标准，与官方酒店标识和预订平台验证使用的数据相同。
• 结构化与规范化: 提供结构化、标准化的数据。
• 数据去重与优先级: 当同一酒店出现在多个来源时，采用优先级系统保留最权威的版本，确保官方分类始终优先于社区贡献的数据。

主要数据端点 (Endpoints)

1. GET /api/hotels

   • 功能: 搜索和筛选数据库中的酒店。
   • 查询参数: country（国家）, city（城市）, stars（星级，1-5）, name（酒店名称）, page（页码）, limit（每页结果数）。

2. GET /api/hotels/:id

   • 功能: 根据ID获取特定酒店的完整详细信息。

3. GET /api/stats/countries

   • 功能: 获取每个国家的酒店数量和平均星级，适用于市场分析。

4. GET /api/stats/stars

   • 功能: 获取按星级划分的酒店分布，可按国家筛选。

5. GET /api/stats/countries/list

   • 功能: 返回数据库中当前可用的所有国家列表。

数据对象结构 (Hotel Object)

字段	类型	描述
id	integer	内部唯一标识符
name	string	官方酒店名称
stars	integer	null
country	string	国家名称
country_code	string	ISO 3166-1 alpha-2 代码
city	string	null
address	string	null
latitude	float	null
longitude	float	null
phone	string	null
website	string	null
email	string	null
source	string	数据源标识符
source_id	string	源注册表中的原始ID
created_at	ISO 8601	首次获取日期
updated_at	ISO 8601	最后更新日期

适用场景

• 旅行搜索引擎: 按城市筛选具有政府核发星级（而非旅客评论平均值）的酒店。
• 预订平台数据增强: 对照官方分类验证或补充物业数据库中的缺失星级。
• 市场情报: 使用/stats端点分析按国家、地区和星级分类的酒店供应情况。
• 价格基准工具: 建立按官方星级分层的定价模型。

访问与限制

• 访问方式: 可通过RapidAPI平台订阅或直接在HotelGrade官网注册获取API密钥访问。
• 基础速率限制示例（官网计划）:
  • 免费计划: 10 请求/分钟，100 请求/天，最大页面大小20。
  • 入门计划 ($9/月): 60 请求/分钟，2,000 请求/天，最大页面大小50。
  • 专业计划 ($29/月): 200 请求/分钟，50,000 请求/天，最大页面大小100。
  • 企业计划: 自定义。

数据源优先级（去重规则）

优先级	数据源
100 (最高)	Atout France, Turismo de Portugal
90	官方地区注册表 (西班牙、意大利、德国、DACH、希腊)
70	DATAtourisme
60	Opendatasoft
10	OpenStreetMap (社区)