海しるAPI v3 ベータ版 提供開始のお知らせ

APIの新たなバージョンとなるv3 APIのベータ版の提供を開始します。

v3では、現行のv2 APIで情報項目ごとに分かれているエンドポイントを整理し、ArcGISのサービスタイプを単位としたエンドポイント構成へ変更します。

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

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

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

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

最新の移行対応表を見る

ベータ版で頂いたご意見・ご要望等を参考にしながら、正式版の提供に向けて対応を進めます。

ベータ版をご利用いただき、APIの仕様や使い勝手等についてご意見・ご要望がございましたら、下記の問合せフォームからお知らせください。

海上保安庁海洋情報部問い合わせフォーム

※ 件名に「海しるAPI v3 ベータ版への意見・要望」と入力してください。

v2 → v3 移行対応表

API仕様書

API v3 リリースノート トップへ戻る