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

No recorded changes to this endpoint across all 22 revisions of this API.