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