概要
GSJ 地質図幅凡例 (ZFK) API は、GSJ 地質図幅凡例データセット (ZFK)に含まれる 岩相単元（LegendUnit）、層相区分（LegendFacies）、凡例構造（LegendGroup）、地質図幅情報（LegendMap）を Web API として取得するためのインターフェースです。
さらに、座標・数値年代・地質名・図幅 map_id などをもとに凡例情報を検索するクエリ API
（pointinfo、maRange、maAt、geologicName、
unitsInBbox、unitsInMap など）も提供しており、
WebGIS や地質情報システム、機械学習・大規模言語モデルなどから
直接 JSON 形式で地質図幅凡例 (ZFK)データにアクセスすることができます。
エンドポイント
1. 個別リソース取得
- 岩相単元（LegendUnit）
-
GET /units/{id}
例： https://gbank.gsj.jp/ld/resource/zfk/units/m1198_u104 - 層相区分（LegendFacies）
-
GET /facies/{id}
例： https://gbank.gsj.jp/ld/resource/zfk/facies/m1198_f006 - 凡例構造（LegendGroup）
-
GET /groups/{id}
例： https://gbank.gsj.jp/ld/resource/zfk/groups/m1198_g001 - 地質図幅情報（LegendMap）
-
GET /maps/{id}
例： https://gbank.gsj.jp/ld/resource/zfk/maps/m1052 - 整備済み図幅一覧（マップコレクション）
-
GET /maps
例： https://gbank.gsj.jp/ld/resource/zfk/maps
現時点で 地質図幅凡例データセット (ZFK)として整備済みの図幅一覧が取得できます。
2. クエリ API（検索機能）
クエリ API はすべて /query/… 以下に定義されており、
JSON 形式のレスポンスを返します。詳細なレスポンス構造は
Swagger UI 版 API ドキュメントで確認できます。
- 座標から岩相単元を取得（pointinfo）
-
GET /query/pointinfo?lat={lat}&lon={lon}
例： https://gbank.gsj.jp/ld/resource/zfk/query/pointinfo?lat=35.60457&lon=139.28532 - 指定年代範囲に該当する単元を検索（maRange）
-
GET /query/maRange?lower_ma={lower}&upper_ma={upper}
例： https://gbank.gsj.jp/ld/resource/zfk/query/maRange?lower_ma=20&upper_ma=10 - 指定年代（Ma）に対応する単元を検索（maAt）
-
GET /query/maAt?ma={ma}
例： https://gbank.gsj.jp/ld/resource/zfk/query/maAt?ma=20 - 地質年代名による検索（ageName）
-
GET /query/ageName?kw={keyword}
例： https://gbank.gsj.jp/ld/resource/zfk/query/ageName?kw=白亜紀 - 地質名・地層名による検索（geologicName）
-
GET /query/geologicName?kw={keyword}
例： https://gbank.gsj.jp/ld/resource/zfk/query/geologicName?kw=足尾 - 矩形範囲内の岩相単元を検索（unitsInBbox）
-
GET /query/unitsInBbox?bbox=minLon,minLat,maxLon,maxLat
例： https://gbank.gsj.jp/ld/resource/zfk/query/unitsInBbox?bbox=139,35,140,36 - 図幅 ID に対応する岩相単元一覧を取得（unitsInMap）
-
GET /query/unitsInMap?map_id={id}
例： https://gbank.gsj.jp/ld/resource/zfk/query/unitsInMap?map_id=1198
ライセンスと注意事項
本 API は、GSJ 地質図幅凡例データセット (ZFK)に対するアクセス手段として提供されており、 データのライセンスおよび出典表示の条件は、データセット本体に準じます。 利用にあたっては、次のページを参照してください。