⽔路通報[過去5年以内の有効分](⼩改正は過去3箇⽉以内) v2
情報の説明︓船舶交通の安全のために必要な情報（航路標識の変更、海上演習、海上作業等）
詳細︓https://www.msil.go.jp/meta/10086j.pdf
Base URLs:
https://api.msil.go.jp/notices-to-mariners/v2

Authentication
API Key (apiKeyHeader)Parameter Name: Ocp-Apim-Subscription-Key, in: header.
API Key (apiKeyQuery)Parameter Name: subscription-key, in: query.

Default
GET /MapServer/
説明
このAPIの情報を返します。
Example responses
200 Response{"name": "⽔路通報[過去5年以内の有効分](⼩改正は過去3箇⽉以内)","description": "船舶交通の安全のために必要な情報（航路標識の変更、海上演習、海上作業等）"}

401 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}429 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

500 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

Responses
StatusMeaning

Description

Schema200

OK

APIの情報を返します。

description

401

Unauthorized

サブスクリプションキーがありません。

error_code

リクエストが集中しています。

error_code

429

500

Too Many
Requests

ArcGIS REST API の レスポンスコードも参照してください。

InternalServer Error

https://developers.arcgis.com/rest/services-

error_code

reference/enterprise/output-formats.htm

query
GET /MapServer/{LayerSelection}/query
JSON出⼒
地理情報を出⼒します。 ⼀度の応答で出⼒できる地理情報レコードは1000レコードです。 クエリーパラメータで条件を指定して出⼒レコード数を調整して下さい。

Parameters
Name

InTypeRequired

Description

Name

InTypeRequired

Description
ジオメトリ番号を⼊⼒します。1はPoint、2はLayerSelection

pathinteger

true

polyline、3はpolygonに対応します。デフォルトは1です。

fquerystringfalse

出⼒形式を指定します。

where

query

stringfalse

フィールドの内容で条件を絞ります。

geometry

query

stringfalse

空間フィルターとして適⽤するジオメトリです。
ジオメトリ パラメータで指定されたジオメトリのタ

geometryType

query

stringfalse

イプ。ジオメトリ タイプは、エンベロープ、ポイン
ト、ライン、またはポリゴンです。デフォルトのジオメトリ タイプはエンベロープです。

inSR

query

stringfalse

⼊⼒ジオメトリの空間参照。
クエリの実⾏中に⼊⼒ジオメトリに適⽤される空間

spatialRel

query

stringfalse

関係。サポートされている空間関係には、交差、包含、エンベロープ交差、内などがあります。デフォ
ルトの空間関係は交差(esriSpatialRelIntersects)です。

distancequery

string

false

units

query

stringfalse

returnGeometryquerybooleanfalse

距離検索条件です。
距離の単位です。距離検索で指定する距離の単位を⼊⼒します。
APIの応答内容にジオメトリ情報を含めるかを設定します。

Detailed descriptions
f: 出⼒形式を指定します。 デフォルトはjsonです。
where: フィールドの内容で条件を絞ります。 このパラメータが指定されていない場合、全ての内容を取り出します。
geometry: 空間フィルターとして適⽤するジオメトリです。 ジオメトリの構造は、ArcGIS REST API によって返されるJSON ジオメトリ オブジェクトの構造と同じです。 エンベロープとポイントの JSON 構造に加えて、より単純なカンマ区切りの構⽂でジオメトリを指定できます。 例: bbox=135.0,35.0,136.0,40.0
inSR: ⼊⼒ジオメトリの空間参照。 空間参照は、既知の ID または空間参照 JSON オブジェクトとして指定できます。 inSRが指定されていない 場合、ジオメトリはマップの空間参照にあると⾒なされます。
distance: 距離検索条件です。 基点の経緯度と距離をカンマ区切りで3点⼊⼒します。 距離の単位はunitsで設定できます。デフォルトはメートルです。 例: distance=135.0,35.0,100.0
returnGeometry: APIの応答内容にジオメトリ情報を含めるかを設定します。 メタ情報のみ必要な場合はfalseに設定してください。 デフォルトはtrueです。
Enumerated Values

Parameter

Value

LayerSelection

1

LayerSelection

2

LayerSelection

3

fjson

f

geojsongeometryType

esriGeometryPoint

geometryType

esriGeometryMultipoint

geometryType

esriGeometryPolyline

geometryType

esriGeometryPolygon

geometryType

esriGeometryEnvelope

spatialRel

esriSpatialRelIntersects

spatialRel

esriSpatialRelContains

spatialRel

esriSpatialRelCrosses

spatialRelesriSpatialRelEnvelopeIntersects

spatialRel

esriSpatialRelIndexIntersects

spatialRel

esriSpatialRelOverlaps

spatialRel

esriSpatialRelTouches

spatialRel

esriSpatialRelWithin

spatialRel

esriSpatialRelRelation

units

esriSRUnit_Meter

units

esriSRUnit_StatuteMileunits

esriSRUnit_Foot

units

esriSRUnit_Kilometer

units

esriSRUnit_NauticalMile

units

esriSRUnit_USNauticalMile

returnGeometry

true

returnGeometry

false

Example responses
200 Response{"displayFieldName": "name","fieldAliases": {"name": "name","description": "description"},"geometryType": "esriGeometryPoint","spatialReference": {"wkid": 4326,"latestWkid": 4326},"fields": [{"name": "name","type": "esriFieldTypeString","alias": "name","length": 8000},{"name": "description","type": "esriFieldTypeString","alias": "description","length": 8000}],"features": [{"attributes": {"name": "瀬⼾内海 杵築湾 − 守江港及び付近
⽔中障害物存在","description": "⼀時関係2018年5115項\n<hr size=\"1\"> ⽔路通報29年5号5074項(T)参照\n 位 置
⽔深約 6.5m\n(1) 33-23-35.6N
131-39-57.8E \n 位 置
⽔深約 7.3m\n(2) 3323-26.9N 131-39-24.4E \n 位 置
⽔深約 10.7m\n(3) 33-23-14.3N 131-40-51.6E \n 位 置
⽔深約 9.5m\n(4) 33-22-25.2N 131-39-04.7E \n 海 図W1218−(1〜3)W1101−(1〜3)JP1101−(1〜3)W1102−\n(1〜3)JP1102\n 出 所
七管区⽔路通報30年7号107項\n<ahref=\"https://www.msil.go.jp/msil/Data/NwNtmConstraints_j.pdf\"
target=\"_blank\">[利⽤上の制限事項]</a>\n\t"},"geometry": {"x": 131.6661,"y": 33.3932}}]}

400 Response{"statusCode": 400,

"message": "Value of the path parameter LAYERSELECTION does not conform to thedefinition. Value 5 is not defined in enum. Line: 1, Position: 1"}

401 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}429 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

500 Response{"statusCode": 401,"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

Responses
StatusMeaning

Description

200

OK

地理情報を返します。

400

Bad Request

パラメータが違います。

None

401

Unauthorized

サブスクリプションキーがありません。

error_code

リクエストが集中しています。

error_code

429

500

Too Many
Requests
Internal
Server Error

Schemanotices-tomariners_geojson

ArcGIS REST API の レスポンスコードも参照してください。https://developers.arcgis.com/rest/servicesreference/enterprise/output-formats.htm

error_codeResponse Schema

exportGET /MapServer/export
画像出⼒
経緯度で指定した範囲に含まれる地理情報をWebメルカトル図法で投影し、PNG画像形式で出⼒します。

Parameters
NameInType

RequiredDescription

bbox

query

stringtrue

出⼒範囲を設定するバウンディングボックスです。

size

query

stringfalse

出⼒する画像のサイズです。

transparent

query

booleanfalse

背景⾊を透明にします。

dpi

query

integerfalse

解像度を指定します。デフォルトは96です。

mapScalequery

integerfalse

縮尺を設定します。

Detailed descriptions
bbox: 出⼒範囲を設定するバウンディングボックスです。 経緯度をカンマ区切りで4点⼊⼒します。 例:
bbox=135.0,35.0,136.0,40.0
size: 出⼒する画像のサイズです。 幅,⾼さをカンマ区切りで⼊⼒します。単位はpixelsです。 例:
size=1920,1080
transparent: 背景⾊を透明にします。 trueなら背景は透過します。デフォルトはfalseです。 例:
transparent=truedpi: 解像度を指定します。デフォルトは96です。 例: dpi=200
mapScale: 縮尺を設定します。 bboxパラメータの中⼼点を基準に 1:mapScaleの⽐率で画像を出⼒します。
例: mapScale=5000000
Example responses
401 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}429 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

500 Response{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

Responses
StatusMeaning

Description

Schema200

OK

PNG画像を返します。

None

401

Unauthorized

サブスクリプションキーがありません。

error_code

リクエストが集中しています。

error_code

429

500

Too Many
Requests
Internal
Server Error

ArcGIS REST API の レスポンスコードも参照してください。
https://developers.arcgis.com/rest/services-

error_code

reference/enterprise/output-formats.htm

Schemaserror_code{"statusCode": 401,
"message": "Access denied due to missing subscription key. Make sure to include
subscription key when making requests to an API."}

Properties
Name

Type

Required

Restrictions

Description

statusCodeinteger(int32)

false

none

状態コード

Name

Type

Required

Restrictions

Description

messagestring(byte)

false

none

エラーメッセージ

description{"name": "⽔路通報[過去5年以内の有効分](⼩改正は過去3箇⽉以内)","description": "船舶交通の安全のために必要な情報（航路標識の変更、海上演習、海上作業等）"}

Properties
Name

Type

Required

Restrictions

Description

namestring

false

none

APIの名前description

string

false

none

APIの説明notices-to-mariners{"displayFieldName": "string","fieldAliases": {"name": "瀬⼾内海 杵築湾 − 守江港及び付近
⽔中障害物存在","description": "⼀時関係2018年5115項\n<hr size=\"1\"> ⽔路通報29年5号5074項(T)参照\n 位 置
⽔深約 6.5m\n(1) 33-23-35.6N
131-39-57.8E \n 位 置
⽔深約 7.3m\n(2) 3323-26.9N 131-39-24.4E \n 位 置
⽔深約 10.7m\n(3) 33-23-14.3N 131-40-51.6E \n 位 置
⽔深約 9.5m\n(4) 33-22-25.2N 131-39-04.7E \n 海 図W1218−(1〜3)W1101−(1〜3)JP1101−(1〜3)W1102−\n(1〜3)JP1102\n 出 所
七管区⽔路通報30年7号107項\n<ahref=\"https://www.msil.go.jp/msil/Data/NwNtmConstraints_j.pdf\"
target=\"_blank\">[利⽤上の制限事項]</a>\n\t"},"geometryType": "string","spatialReference": {"wkid": 0,"latestWkid": 0},"fields": [{"name": "string","type": "string","alias": "string","length": 0}],"features": [{"attributes": {"name": "瀬⼾内海 杵築湾 − 守江港及び付近
⽔中障害物存在","description": "⼀時関係2018年5115項\n<hr size=\"1\"> ⽔路通報29年5号5074項(T)参照\n 位 置
⽔深約 6.5m\n(1) 33-23-35.6N
131-39-57.8E \n 位 置
⽔深約 7.3m\n(2) 3323-26.9N 131-39-24.4E \n 位 置
⽔深約 10.7m\n(3) 33-23-14.3N 131-40-51.6E \n 位 置
⽔深約 9.5m\n(4) 33-22-25.2N 131-39-04.7E \n 海 図W1218−(1〜3)W1101−(1〜3)JP1101−(1〜3)W1102−\n(1〜3)JP1102\n 出 所
七管区⽔路通報30年7号107項\n<ahref=\"https://www.msil.go.jp/msil/Data/NwNtmConstraints_j.pdf\"
target=\"_blank\">[利⽤上の制限事項]</a>\n\t"},"geometry": {"x": 0,"y": 0}}]}

Properties
NameType

Required

Restrictions

Description

displayFieldName

stringfalse

nonenonefieldAliases

attributes

false

none

none

geometryType

string

false

none

none

spatialReference

object

false

none

none

» wkidinteger(int64)

false

none

none

» latestWkid

integer(int64)

false

none

none

fields[object]

false

none

none

» namestring

false

none

none

» typestring

false

none

none

» aliasstring

false

none

none

» length

integer(int64)

false

none

none

features[object]

false

none

none

» attributes

attributes

false

none

none

» geometry

object

false

none

none

»» x

number

false

none

none

Name

Type

Required

Restrictions

Description»» ynumber

false

none

none

notices-to-mariners_geojson{"type": "string","crs": {"type": "string","properties": {"name": "string"}},"features": [{"type": "string","geometry": {"type": "string","coordinates": [0]},"properties": {"name": "瀬⼾内海 杵築湾 − 守江港及び付近
⽔中障害物存在","description": "⼀時関係2018年5115項\n<hr size=\"1\"> ⽔路通報29年5号5074項(T)参照\n 位 置
⽔深約 6.5m\n(1) 33-23-35.6N
131-39-57.8E \n 位 置
⽔深約 7.3m\n(2) 3323-26.9N 131-39-24.4E \n 位 置
⽔深約 10.7m\n(3) 33-23-14.3N 131-40-51.6E \n 位 置
⽔深約 9.5m\n(4) 33-22-25.2N 131-39-04.7E \n 海 図W1218−(1〜3)W1101−(1〜3)JP1101−(1〜3)W1102−\n(1〜3)JP1102\n 出 所
七管区⽔路通報30年7号107項\n<ahref=\"https://www.msil.go.jp/msil/Data/NwNtmConstraints_j.pdf\"
target=\"_blank\">[利⽤上の制限事項]</a>\n\t"}}]}Properties
NameType

Required

Restrictions

Description

type

stringfalse

nonenonecrs

objectfalse

nonenone» typestringfalse

nonenone» properties

object

false

none

none

Name

Type

Required

Restrictions

Description»» namestring

false

none

none

features[object]

false

none

none

» typestring

false

none

none

» geometry

object

false

none

none

»» typestring

false

none

none

»» coordinates[number]

false

none

none

» properties

attributes

false

none

none

attributes{"name": "瀬⼾内海 杵築湾 − 守江港及び付近
⽔中障害物存在","description": "⼀時関係2018年5115項\n<hr size=\"1\"> ⽔路通報29年5号5074項(T)参照\n 位 置
⽔深約 6.5m\n(1) 33-23-35.6N
131-39-57.8E \n 位 置
⽔深約 7.3m\n(2) 3323-26.9N 131-39-24.4E \n 位 置
⽔深約 10.7m\n(3) 33-23-14.3N 131-40-51.6E \n 位 置
⽔深約 9.5m\n(4) 33-22-25.2N 131-39-04.7E \n 海 図W1218−(1〜3)W1101−(1〜3)JP1101−(1〜3)W1102−\n(1〜3)JP1102\n 出 所
七管区⽔路通報30年7号107項\n<ahref=\"https://www.msil.go.jp/msil/Data/NwNtmConstraints_j.pdf\"
target=\"_blank\">[利⽤上の制限事項]</a>\n\t"}Properties
Name

Type

Required

Restrictions

Description

namestring

false

none

名前

description

stringfalsenone情報