Japan Civic Facilities — Geo Search

Geo-search Japanese civic facilities (AEDs, evacuation sites, hospitals, care facilities, cultural properties, fire hydrants) from official municipal open data. Normalized records with distance + CC BY attribution. REST API and MCP tools for AI agents.

原始信息汇总

数据集概述

• 名称: Japan Civic Facilities — Geo Search（日本公共设施地理搜索）
• 提供方: kumota-1985（RapidAPI平台）
• 订阅方案: BASIC（免费）、PRO（$9.99/月）、ULTRA（$29.99/月）

功能描述

提供日本全国范围内公共设施（如AED、避难所、医院、护理设施、文化财产、消防栓等）的地理位置搜索服务。数据源自官方市政开放数据，经规范化处理后以REST API和MCP工具形式提供，适用于应用程序和AI代理。

可搜索的设施类别

类别	说明
aed	AED（自动体外除颤器）位置
evacuation_space	指定紧急避难场所
hospital	医院及诊所
care_service	老年人护理设施
cultural_property	文化财产
fire_hydrant	消防栓

API 端点说明

1. GET /api/facilities/categories

• 功能：列出所有可用的设施类别。
• 参数：无。

2. GET /api/facilities/search

• 功能：以某个坐标为中心点，按类别搜索附近设施。
• 参数列表：

参数	必填	默认值	说明
category	是	—	设施类别（见上表）
latitude	是	—	纬度（-90 ~ 90）
longitude	是	—	经度（-180 ~ 180）
radius_km	否	3	搜索半径（公里），最大50
limit	否	20	返回最大记录数（1 ~ 100）

• 排序规则：结果按距离由近到远排列。
• 返回字段示例：category、name、address、municipality、municipality_code、postcode、phone、latitude、longitude、distance_km。
• 此外，响应中还会提供 meta.attributions 属性，包含数据来源的CC BY 4.0署名信息。

3. POST /api/mcp/tools/list

• 功能：返回MCP工具目录。
• 工具名称：search_nearby_facilities

4. POST /api/mcp/tools/call

• 功能：调用MCP工具执行搜索。
• 请求体示例：{"name": "search_nearby_facilities", "arguments": {"category": "evacuation_space", "latitude": 35.681, "longitude": 139.767, "radius_km": 2}}
• 返回格式：对AI代理友好的Markdown文本。

认证方式

无需手动管理API密钥。用户订阅套餐后，RapidAPI会在请求中自动注入 X-RapidAPI-Key 和 X-RapidAPI-Host 头信息。

数据来源与许可

• 数据来源：日本市政开放数据，经由 BODIK（九州大数据与开放数据倡议）聚合。
• 许可协议：CC BY 4.0。
• 使用要求：展示数据时必须附带 meta.attributions 中的署名文本（如 display_text），以符合许可条款。
• 免责声明：本服务是独立服务，与BODIK或任何市政机构无关。数据准确性和时效性不保证，用于紧急情况前请自行核实。