Japan National Land Numerical Information (国土数値情報 / MLIT) — index

Unofficial Apify Actor that indexes Japan's National Land Numerical Information (国土数値情報, published by the Ministry of Land, Infrastructure, Transport and Tourism, MLIT) download site at https://nlftp.mlit.go.jp/ksj/.

国土数値情報 is Japan's national GIS master data: administrative boundaries, railways and roads, public facilities, land use, and disaster / hazard zones — distributed as ZIP archives (GML / Shapefile). This Actor gives you a clean, English-labelled, machine-readable index of those datasets and the direct download URL of every ZIP, so you can discover and fetch exactly the layers you need. It does not re-host or reprocess the geometry — each record points you at the official file.

Quick start — verified input

Copy, paste, run. This exact input is verified on the platform (SUCCEEDED, items > 0):

{
  "mode": "list_datasets",
  "dataType": "N03",
  "prefecture": "Tokyo",
  "maxItems": 50
}

Running with no input at all also works (it lists the N03 administrative-boundary downloads). To discover other dataType identifiers run {"mode": "list_catalog"} (optionally with "query": "行政").

What it does

Two modes:

• list_catalog — parse the site index into the catalogue of dataset types ("dataTypes"). One record per dataType: its identifier (e.g. N03), Japanese title, and the URL of its download page. Optional query substring filter.
• list_datasets — parse one dataType's download page into its individual ZIP entries. One record per downloadable file: area (prefecture / nationwide), geodetic datum, year, format, file name, size, and the direct downloadUrl. Give it a dataType (e.g. N03) or a datalistUrl from a list_catalog run; optionally filter by prefecture (地域 substring) and year.

Input reference

Field	Mode	Description
mode	both	list_datasets (default) or list_catalog. Case-insensitive; a bare dataType selects list_datasets, a bare query selects list_catalog.
dataType	list_datasets	KSJ identifier, e.g. N03 (行政区域), P34 (市区町村役場), A31a (洪水浸水想定区域). Any case (n03). Required in list_datasets mode (unless datalistUrl).
datalistUrl	list_datasets	A https://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-<id>.html page (from a list_catalog run).
prefecture	list_datasets	Area filter: Tokyo / 東京都 / 13 (mapped to the site's 地域 label 東京), or a raw label such as 全国.
year	list_datasets	4-digit calendar year, e.g. 2024.
query	list_catalog	Substring filter over identifier / title, e.g. 行政, N03.
maxItems	both	Max records, 1–100000 (default 1000).
maxApiRequests	both	Hard per-run upstream request cap, 1–25 (default 10).
proxyConfiguration	both	Optional Apify proxy; default is a direct connection.

Values are validated before the first request; an invalid value fails the run immediately with a message that lists the valid values.

Common input mistakes

Mistake	Correct
"dataType": "行政区域" (a title)	the identifier "N03" — find it with {"mode": "list_catalog", "query": "行政"}
{"mode": "list_datasets", "query": "行政"}	query filters the catalogue: use "mode": "list_catalog", or give a dataType
"prefecture": "Osaka-shi" (a city)	"prefecture": "Osaka" — downloads are per prefecture or nationwide (全国)
"year": "令和6年" / "R6"	the calendar year "2024"
"datalistUrl": "https://nlftp.mlit.go.jp/ksj/"	the datalist page: https://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-N03-2026.html
"maxItems": "all"	a number, e.g. 1000

Empty results?

A run that finds nothing completes with 0 items and a warning in the log (not a failure). Typical causes: a prefecture filter on a dataType that is only published nationwide (many A/P series have a single 全国 row — drop prefecture or set it to 全国), a year the dataType was not published in (the datalist shows the available years — drop year), or a query in list_catalog mode that matches no identifier/title (try a shorter Japanese substring).

Example output record

{
  "identifier": "N03",
  "datasetTitle": "行政区域データ",
  "area": "東京",
  "datum": "世界測地系",
  "fiscalYear": "2026年（令和8年）",
  "year": 2026,
  "format": "GML",
  "fileName": "N03-20260101_13_GML.zip",
  "fileSizeLabel": "12.54MB",
  "downloadUrl": "https://nlftp.mlit.go.jp/ksj/gml/data/N03/N03-2026/N03-20260101_13_GML.zip",
  "datalistUrl": "https://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-N03-2026.html",
  "source": "国土数値情報ダウンロードサイト / National Land Numerical Information download site (MLIT)",
  "sourceUrl": "https://nlftp.mlit.go.jp/ksj/",
  "license": "出典：国土交通省国土数値情報ダウンロードサイト …",
  "retrievedAt": "2026-08-26T…Z"
}

Every record carries the four attribution fields (source, sourceUrl, license, retrievedAt) with the required 出典 credit baked into license.

Search terms

japan gis data, japan administrative boundaries, japan geospatial data english, kokudo suuchi, 国土数値情報, japan shapefile download, japan municipal boundaries, japan hazard map data, MLIT geospatial, japan prefecture polygons

Legal / disclaimer

• Public open data. This Actor reads the public MLIT 国土数値情報 download site (no login, no key). Content is licensed under the 公共データ利用規約 (第1.0版) / Public Data License 1.0 (PDL1.0), which permits commercial use, reproduction, translation and adaptation with attribution. See the site terms (https://nlftp.mlit.go.jp/ksj/other/agreement.html) and PDL1.0 (https://www.digital.go.jp/resources/open_data/public_data_license_v1.0). The site 利用規約 and PDL1.0 contain no clause prohibiting automated download, crawling or bulk access, and the site's robots.txt returns 404 (no restriction).
• Unofficial tool — not affiliated with, endorsed by, or connected to MLIT or the National Land Information Division. "国土数値情報" and related names are used only to describe the data source.
• Per-dataset licences vary. Some datasets carry their own condition — 「オープンデータ(CC BY 4.0)一部制限」/「商用可」/「非商用」— or a 測量法 background map that requires 国土地理院 approval to reproduce. The authoritative condition is each dataset page's 「このデータの使用許諾条件」欄. You are responsible for confirming the licence and content of any dataset you download before use.
• Attribution is required. When you use the data, cite the source, e.g. 「出典：国土交通省国土数値情報ダウンロードサイト（当該ページのURL）」; if you edit or process it, also state that you did so.
• You are responsible for compliance with the source site's terms and all applicable laws (including data-protection law such as GDPR/APPI) in your use of the retrieved data. This Actor indexes GIS-master catalogue metadata and contains no personal data.

Politeness

Single sequential connection, ≥ 1.2 s between requests, exponential backoff on 429/5xx, and a hard per-run request budget (maxApiRequests). The Actor never attempts rate-limit, CAPTCHA or WAF/JS-challenge evasion; a persistent block fails the run visibly. It uses an honest, self-identifying User-Agent.