japan

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.

get/japan/rail/stations/{station_id}/nearby

Path parameters

station_idstring required

Query parameters

radius_minteger

Search radius in meters; default 5 km.

Search radius in meters; default 5 km.

tierstring nullable

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.

limitinteger

Max results, sorted by ascending distance.

Max results, sorted by ascending distance.

Response

Successful Response

object required

Changes