海しるAPI v3 リリースノート

海しるAPIの新たなバージョンとなるAPI v3を提供します。

API v3では、従来の情報項目ごとのAPI提供から、ArcGISの標準的なサービスを基盤とした提供方式に移行します。

これにより、海洋情報をGISデータとしてより容易かつ柔軟に利用・連携できるようになります。

API v3はベータ版（提供開始済）、正式版の順に段階的に提供します。 また、ベータ版・正式版の中でも、情報項目ごとに準備が整ったものから段階的に提供します。

提供状況については、本サイトの「リリース一覧」で随時お知らせします。

• エンドポイントの構成を変更します。

  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提供では、「潮汐推算」・「潮流推算」・「データカタログ」以外の情報を対象として、新しいエンドポイント構成を段階的に提供します。

v3 APIは、最終的に以下の5種類のエンドポイント構成で提供する予定です。

※ 「潮汐推算」・「潮流推算」・「データカタログ」はすでにv3で提供しているため、 今回の変更対象外です。

v2 APIをご利用中の方は、v3 APIへの移行にあたり、現在ご利用のエンドポイントが v3ではどのエンドポイントに対応するかをご確認ください。

最新の移行対応表を見る

APIの利用方法や仕様については、 以下のドキュメントをご確認ください。