List Japan Rail Station Nearby
Return JapanPlace rows within radius_m of the named station.
Uses ST_DWithin(geography) so the radius is a true great-circle distance, not a degree approximation. Both columns (the station's geom and japan_places.geom) are GiST-indexed; the predicate pushes through to the index when wrapped in ::geography.
Returns: { "station": { id, station_name_ja, station_name_en, line_ids, lat, lng }, "places": [ { id, name, en_name, rank, type, prefecture, lat, lng, tagline, photo_url, distance_m } ] }
Photo URL is the first japan_place_photos.url if present (matches the existing /api/japan listing's serialization). distance_m is the great-circle distance in meters, rounded to the nearest meter.
Path parameters
Query parameters
Search radius in meters; default 5 km.
Search radius in meters; default 5 km.
Optionally restrict to a single JTB tier. Only SA and A are accepted today — B-tier is loaded into the DB but excluded from public surfaces (no photo coverage yet, see program/app/japan/types.ts). Loosen this regex when B-tier is officially supported.
Optionally restrict to a single JTB tier. Only SA and A are accepted today — B-tier is loaded into the DB but excluded from public surfaces (no photo coverage yet, see program/app/japan/types.ts). Loosen this regex when B-tier is officially supported.
Max results, sorted by ascending distance.
Max results, sorted by ascending distance.
Response
Successful Response
Changes
No recorded changes to this endpoint across all 22 revisions of this API.