目次
リリース一覧
| 公開日 | バージョン | タイトル | 状況 |
|---|---|---|---|
| 2026年8月27日 | v3 | 海しるAPI v3 ベータ版提供開始のお知らせ | BETA |
海しるAPI v3について
海しるAPIの新たなバージョンとなる「v3 API」をベータ版（提供開始済）、正式版の順に段階的に提供します。
また、ベータ版・正式版の中でも、情報項目ごとに準備が整ったものから段階的に提供します。
提供状況については、本サイトの「リリース一覧」で随時お知らせします。
令和8年（2026年）10月から段階的に提供開始予定
現行のv2 APIは、v3 APIの正式提供から1年後を目途（2027年12月末）に提供終了予定です。
v2をご利用の皆様におかれましては、お手数をおかけしますが、v3への移行をご検討くださいますようお願いいたします。
現在お使いの海しるAPIサブスクリプションキーは、v3でも変わらずお使い頂けます。
その他、利用規約等についても変更は予定しておりません。
v2 APIからの主な変更点
-
エンドポイントの構成を変更します。
v2では情報項目ごとにエンドポイントを設けていましたが、 v3ではArcGISのサービスタイプを単位とした構成に変更します。
v3のエンドポイント構成の概要は「v3 APIの提供構成」を、 v2の各情報項目のエンドポイントが、v3のどのエンドポイントに対応するかは、「最新の移行対応表」をご確認ください。
-
GISソフトウェアでURLを設定するだけでデータを利用できます。
v3では、プラグイン等の追加インストールを行うことなく、ArcGIS OnlineやQGIS等でURLを設定するだけでv3で提供している情報をすぐに解析可能なデータとして利用できます。
詳しいご利用方法は、「利用者向け説明書」をご確認ください。
-
一部の操作を変更・廃止します。
v2で利用可能な一部の操作が、v3では変更・廃止されます。
一例として、v3の移行先がArcGIS FeatureServiceの情報の場合、FeatureServiceはベクトルデータを返すAPIのため、v2で利用可能な操作「画像出力」は廃止されます。
v2と、移行先のv3における利用可能な操作の対応は「最新の移行対応表」をご確認ください。
-
一部のパラメータ、レスポンスを変更します。
設定可能なパラメータとレスポンスの例は、「海しるAPI v3仕様書」でご確認いただけます。
また、パラメータについては、海しるAPIウェブサイトの下記APIページでもご確認いただけます。下記ページではTry it機能もご利用いただけます。
・API ArcGIS FeatureServiceのウェブページ
・API ArcGIS ImageServiceのウェブページ（準備中）
・API ArcGIS MapServiceのウェブページ（準備中）
今回の変更対象
「潮汐推算」・「潮流推算」・「データカタログ」については、すでにv3 APIとして提供しているため、今回の変更対象外です。
今回のv3提供では、「潮汐推算」・「潮流推算」・「データカタログ」以外の情報を対象として、新しいエンドポイント構成を段階的に提供します。
v3 APIのエンドポイント構成概要
v3 APIは、最終的に以下の5種類のエンドポイント構成で提供する予定です。
| エンドポイント | 対応する情報 | 提供状況 |
|---|---|---|
| ArcGIS FeatureService | 島名など、大多数のv2の情報項目が対応 | BETA版 提供済み |
| ArcGIS ImageService | 検討中 | 検討中 |
| ArcGIS MapService | 検討中 | 検討中 |
| 潮汐推算・潮流推算 | 潮汐推算、潮流推算 | 正式版 提供済み |
| データカタログ | データカタログ | 正式版 提供済み |
※ 「潮汐推算」・「潮流推算」・「データカタログ」はすでにv3で提供しているため、 今回の変更対象外です。
v2 → v3 移行情報
v2 APIをご利用中の方は、v3 APIへの移行にあたり、現在ご利用のエンドポイントが v3ではどのエンドポイントに対応するかをご確認ください。
ドキュメント
APIの利用方法や仕様については、 以下のドキュメントをご確認ください。