PAREA-APIのバージョンアップに関する事前案内

いつも地図コンテンツAPI配信サービス「PAREA-API」をご利用いただきありがとうございます。
本書はPAREA-APIの次回バージョンアップにおいて、データの仕様変更等について、利用者様が円滑にご準備いただけるよう、仕様変更内容について事前案内するものです。

以下の通り、バージョンアップのリリースを予定しています。
本書の内容は、本書配信時点での予定となりますため、今後変更が生じる場合があります。
詳細な仕様は、バージョンアップリリース予定日より2週間前に配信するリリース告知書にてご案内いたしますので、ご了承いただけますようお願い申し上げます。

2024年5月29日（水）13時～
※バージョンアップに伴うサービス停止は発生しません。

バージョン2（v2）は今回新規に配信されます。
バージョン1（v1）の配信はそのまま有効です。
バージョン4（v4）は配信されなくなります。

今回のバージョンアップには、利用者様側での改修作業を必要とするデータの削除・変更等はございません。

PAREA-APIが配信するコンテンツ「地価公示」、「地価公示(固定)」の諸元である国土数値情報「地価公示データ」において、今年度公開分のデータより仕様変更があることを確認しました。
PAREA-APIは、今年度の「地価公示」「地価公示（固定）」の更新においては、独自にデータを加工し、従来のPAREA-APIと同じ仕様で公開することを予定しております。
2025年度以降の更新においては、諸元データの仕様に合わせて仕様変更を行う予定がございます。
本コンテンツをご利用のお客様には、ご了承頂けますようよろしくお願いいたします。

（参考）国土数値情報　地価公示データ
https://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-L01-2024.html

本コンテンツの諸元データが本年を持って販売終了となりました為、本コンテンツは2024年5月バージョンアップでの更新を最後とし、次年度より提供を終了します。
なお現在、本コンテンツに代わる年収世帯数データの公開を計画しておりますが、本件については確定後に改めてご案内させていただきます。

現行のPAREA-Townは再編前の行政区となりますので、ご了承くださいませ。
なお、実施予定時期については現在調整中の為、変更となる場合がございます。

◆影響があるコンテンツ
　「PAREA-Town」
　「PAREA-Stat.」シリーズ
　「将来推計人口」
　「住民基本台帳」

但し、上記以外のコンテンツでも、諸元データにより行政区再編の反映状況が異なりますのでご注意いただけますようお願いします。

本書の内容に関するお問い合わせは、次のメールアドレスまでお寄せください。

PAREA-APIお問い合わせ先： pareaapi_support@kk-grp.jp

○ リリースサイクル
■ PAREA-APIは、四半期に1度（概ね2月・5月・8月・11月頃）新バージョンをリリースします。
■ バージョン1(v1)～バージョン4(v4)までをローテーションし、v4の次はv1に戻ります。
■ 各バージョンはリリース後、2世代先のバージョンがリリースされるまでの約6カ月間使い続ける事ができます。
■ 各コンテンツの追加、更新、仕様変更、廃止等は、バージョン毎に行われます。

（図1）リリースサイクルとバージョン指定の関係

○ バージョン指定
　■ 現在存在するバージョンのうち、参照するバージョンを指定する事ができます。
　■ バージョンを指定することで、各コンテンツの更新、仕様変更等に対して、アプリケーション側で仕様変更等を反映するタイミングをコントロールいただけます。
　■ バージョンを指定しない場合は、常に最新バージョンを参照します。
　■ バージョン指定なし：
　　●常にその時の最新バージョンを参照します。
　　●新規コンテンツや更新されたデータをいち早くアプリケーション側に取り入れる事ができます。
　　●コンテンツの仕様変更に対して即座にアプリケーション側の設定変更を行う必要があります。
　　●データ更新における未検知のエラーが生じる場合があります。
　■ バージョン0指定：
　　●常にその時の1世代前のバージョンを参照します。
　　●コンテンツの仕様変更に対して、アプリケーション側の設定変更までに一定期間の準備期間を持つことができます。
　　●リリース後約3カ月間運用された比較的安定的な環境です。

○PAREA-APIで用いる用語を以下の通り定義します。
　■ コンテンツ
　　●PAREA-APIから提供されるテーマ毎に分けた情報群を指す。
　■ データ
　　●コンテンツに含まれる画像や文字や数値等の情報を指す。
　■ アプリケーション
　　●PAREA-APIご利用者がお持ちの、PAREA-APIを組み込むシステム、サービス、アプリケーション等を指す。