Gachi Data API — Japan Station & Accessibility Data

{'type': 'object', 'properties': {'area': {'type': 'string', 'description': 'Optional prefecture code (01–47, e.g. 13 = Tokyo) or JMA forecast-area code.'}}}

{'type': 'object', 'properties': {'count': {'description': 'Number of active alerts.'}, 'stale': {'description': 'True if the snapshot is stale.'}, 'alerts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Active JMA river-flood / landslide alerts with level, area, summary, issue time.'}, 'source': {'description': 'Source label.'}, 'coverage': {'description': 'What this feed covers — string or array of categories.'}, 'disclaimer': {'description': 'Relay disclaimer (not a warning issued by this service).'}, 'fetched_at': {'description': 'When the snapshot was fetched.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}}, 'description': 'Live JMA river-flood & landslide alerts.', 'additionalProperties': True}

{'type': 'object', 'required': ['name_or_code'], 'properties': {'fields': {'type': 'string', 'description': 'Optional comma-separated subset: vacancy,ridership,population,hazard,land_price,livability.'}, 'name_or_code': {'type': 'string', 'description': '5-digit 全国地方公共団体コード (e.g. 13104) or exact municipality name (Shinjuku-ku / 新宿区).'}}}

{'type': 'object', 'properties': {'hazard': {'description': 'Hazard categories.'}, 'vacancy': {'description': 'Housing-vacancy counts (2003–2023).'}, 'ridership': {'description': 'Nearest-station ridership trend.'}, 'land_price': {'description': 'Published land prices near the centroid.'}, 'livability': {'description': 'Livability counts.'}, 'population': {'description': 'Population / future estimate.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}, 'municipality': {'description': 'Resolved municipality + code.'}, 'hazard_disclaimer': {'description': 'Hazard usage disclaimer.'}}, 'description': 'Official municipality data (vacancy, ridership, hazard, land price, livability).', 'additionalProperties': True}

{'type': 'object', 'required': ['city'], 'properties': {'city': {'type': 'string', 'description': 'Municipality name in Japanese (e.g. 那覇市, 渋谷区, 上天草市). Prefix the prefecture for accuracy.'}}}

{'type': 'object', 'properties': {'city': {'description': 'Resolved municipality.'}, 'note': {'description': 'Human-readable note.'}, 'count': {'description': 'Toilets returned.'}, 'error': {'description': 'Set when nothing was found.'}, 'toilets': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Public toilets with wheelchair / baby-seat / ostomate flags, address and coordinates.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}}, 'description': 'Public toilets in a municipality.', 'additionalProperties': True}

{'type': 'object', 'required': ['station_name'], 'properties': {'station_name': {'type': 'string', 'description': 'Station name in Japanese (新宿) or romaji (Shinjuku).'}}}

{'type': 'object', 'properties': {'count': {'description': 'Number of alerts.'}, 'stale': {'description': 'True if stale.'}, 'alerts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'JMA alerts affecting the prefecture.'}, 'station': {'description': 'Resolved station.'}, 'disclaimer': {'description': 'Relay disclaimer.'}, 'fetched_at': {'description': 'When the snapshot was fetched.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}}, 'description': "Live JMA alerts for a station's prefecture.", 'additionalProperties': True}

{'type': 'object', 'required': [], 'properties': {'fields': {'type': 'string', 'description': 'Optional comma-separated subset: vacancy,ridership,population,hazard,land_price,livability.'}, 'station_id': {'type': 'string', 'description': 'Japan Station Master station_id (e.g. st_00001). Alternative to station_name.'}, 'station_name': {'type': 'string', 'description': 'Station name in English/romaji (Shinjuku) or Japanese (新宿). Provide this or station_id.'}}}

{'type': 'object', 'properties': {'hazard': {'description': 'Hazard categories.'}, 'station': {'description': 'Resolved station.'}, 'vacancy': {'description': 'Housing-vacancy counts.'}, 'ridership': {'description': 'Ridership trend.'}, 'land_price': {'description': 'Land prices near the centroid.'}, 'livability': {'description': 'Livability counts.'}, 'population': {'description': 'Population / future estimate.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}, 'municipality': {'description': 'Municipality + code.'}}, 'description': "Official data for a station's municipality.", 'additionalProperties': True}

{'type': 'object', 'required': ['station_name'], 'properties': {'station_name': {'type': 'string', 'description': 'Station name in Japanese (新宿, 武蔵小杉) or romaji (Shinjuku, Musashi-Kosugi).'}}}

{'type': 'object', 'properties': {'hazard': {'description': 'Official categories: flood inundation depth, landform/liquefaction, storm-surge.'}, 'station': {'description': 'Resolved station + coordinates.'}, 'disclaimer': {'description': 'Usage disclaimer (not a substitute for official maps).'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}}, 'description': 'Official disaster-risk categories at a station (MLIT relay).', 'additionalProperties': True}

{'type': 'object', 'required': ['station'], 'properties': {'station': {'type': 'string', 'description': 'Station name in Japanese (新宿, 渋谷) or romaji for major stations (Shinjuku, Shibuya, Kita-Senju).'}}}

{'type': 'object', 'properties': {'note': {'description': 'Human-readable note.'}, 'count': {'description': 'Toilets returned.'}, 'error': {'description': 'Set when nothing was found.'}, 'layer': {'description': 'Data layer (e.g. in_station_gate).'}, 'source': {'description': 'Data source label.'}, 'station': {'description': 'Resolved station (English).'}, 'toilets': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Accessible toilets with floor, gender, equipment and nearest exit.'}, 'station_ja': {'description': 'Station name in Japanese.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}, 'station_name_source': {'description': 'How the name was resolved.'}}, 'description': 'Wheelchair-accessible / multipurpose toilets inside a station.', 'additionalProperties': True}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Line or station name (English or Japanese), e.g. "Yamanote" or "新宿".'}}}

{'type': 'object', 'properties': {'count': {'description': 'Number of lines.'}, 'lines': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Per-line status: normal / delayed / suspended / resumed, with cause.'}, 'query': {'description': 'Echo of the query.'}, 'stale': {'description': 'True if stale.'}, 'fetched_at': {'description': 'When the snapshot was fetched.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}}, 'description': 'Live Tokyo-area train service status.', 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'tools': {'description': 'Number of tools exposed by this server.'}, 'server': {'description': 'Server name.'}, 'status': {'description': 'Always "ok" when the server is reachable.'}, 'version': {'description': 'Deploy version.'}, 'realtime_layers': {'type': 'object', 'properties': {'jma_alerts_updated': {'description': 'When the JMA alerts snapshot was last fetched.'}, 'train_status_updated': {'description': 'When the train-status snapshot was last fetched.'}}, 'description': 'Update times of the realtime KV snapshots (a field is omitted if that layer is unavailable).', 'additionalProperties': True}, 'stations_covered': {'description': 'Stations with accessible-toilet data.'}, 'rate_limit_noauth': {'description': 'No-auth rate limit.'}}, 'description': 'Health check: server identity + realtime-layer freshness.', 'additionalProperties': True}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Natural-language description of the station/area you want (ja/en). Concrete attribute words (朝ラー, wheelchair toilet, terminal, 水害リスク低) match best.'}, 'pref': {'type': 'string', 'description': 'Optional prefecture filter, Japanese (東京都, 千葉 OK) or romaji (tokyo/osaka). Auto-inferred from the query text when omitted.'}, 'limit': {'type': 'number', 'description': 'Max results (default 10; max 20, or 300 when name_contains is given — set limit >= name_matches_total for exhaustive name-match coverage).'}, 'diaper': {'type': 'boolean', 'description': 'Require a diaper changing table in station toilets (auto-inferred from おむつ/子連れ…).'}, 'ramen_min': {'type': 'number', 'description': 'Require at least this many ramen shops nearby (e.g. 30).'}, 'late_ramen': {'type': 'boolean', 'description': 'Require late-night ramen nearby (auto-inferred from 深夜/late night…).'}, 'morning_ramen': {'type': 'boolean', 'description': 'Require morning-ramen availability nearby (auto-inferred from 朝ラー/morning…).'}, 'name_contains': {'type': 'string', 'description': 'Substring filter on the station name (matches both 日本語 name_ja and romaji name, e.g. "谷" or "sakura"). ANDs with other filters; q still ranks the matches. Use for "stations whose name contains X" requests that semantic search cannot guarantee.'}, 'flood_rank_max': {'type': 'number', 'description': 'Max official flood inundation-depth rank 0–6 (0 = no assumed inundation; auto-inferred from 水害リスク低/flood-safe…).'}, 'accessible_toilet_min': {'type': 'number', 'description': 'Require at least this many in-station accessible toilets (Tokyo stations only; auto-inferred from 車椅子/wheelchair…).'}}}

{'type': 'object', 'properties': {'note': {'description': 'Present when the query contains taste/quality words: they are not evaluated (no review data).'}, 'count': {'description': 'Results returned.'}, 'notes': {'description': 'Coverage caveats (toilet stats Tokyo-only, ridership Greater-Tokyo-only).'}, 'query': {'description': 'Echo of the query.'}, 'stations': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Matching stations, best first: name, pref, similarity, ramen stats, toilet stats, official hazard categories (plus risk_notes when an official hazard category not covered by the filter is high), lines, ridership.'}, 'disclaimer': {'description': 'Hazard usage disclaimer.'}, 'attribution': {'description': 'Data source(s), license and provenance — an object, or an array of sources.'}, 'stats_as_of': {'description': 'Freshness of the underlying ramen stats (YYYY-MM-DD).'}, 'soft_filters': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Inferred facility filters applied as a score BOOST (confirmed stations get +BOOST on similarity = final_score; unknown/missing never excluded), with coverage note. Present only when active.'}, 'filter_source': {'description': 'explicit / inferred / none — how the filters were chosen.'}, 'applied_filters': {'description': 'Hard metadata filters actually applied (explicit + inferred; includes name_contains when given).'}, 'name_matches_total': {'description': 'Total stations whose name matched name_contains (before ranking/limit). Present only in name_contains mode.'}}, 'description': 'Semantic station discovery with hybrid filters.', 'additionalProperties': True}