ArcGIS for Developers 開発リソース集

バージョン 3.x から 4.x への移行

バージョン 4.0 では ArcGIS API for JavaScript の構成要素が大きく見直され、機能拡張が行われています。バージョン 3.x で開発したアプリケーションをアップデートすることも可能ですが、アプリケーションを書き換えることを検討してください。

本トピックでは 3.x の API で作成した既存のアプリケーションを 4.0 に移行するために必要な情報を解説します。API で更新された仕様はいくつかありますが、その中でも重要な項目について紹介します。

プロパティのハンドリング
View の利用
Map と Layer の仕様
モジュールとパッケージの更新
Web マップのサポート
AMD の利用
廃止項目

プロパティのハンドリング

3.x ではいくつかのプロパティは、読み取り/書き込み用のクラス固有のメソッド名を呼び出すことで、値を get（読み取り）または set（書き込み）することができました。4.0 ではメソッドの呼び出しが刷新され、シンプルで一貫した方法で全てのプロパティの読み取り、書き込みをサポートします。

オブジェクトに直接値を書き込む方法

// ベースマップのタイプを設定
map.basemap = 'oceans';

オブジェクトから直接値を読み取る方法

// ベースマップのタイトルを取得
var title = map.basemap.title;

例えば、3.x でフィーチャレイヤーのフィルター定義式（definitionExpression）を設定するには、以下のように記述していました。

myFeatureLayer.setDefinitionExpression(expression);

4.0 では、以下の様に記述します。

myFeatureLayer.definitionExpression = expression;

4.0 では、以下に記述したように .get() または .set() を使用して、深い階層のプロパティにアクセスすることも可能です。

var basemapTitle = map.get("basemap.title");

プロパティの変更の監視

3.x ではプロパティの変更はイベントでハンドリングされていましたが、4.0 ではプロパティの変更の監視を簡単に行うことができます。プロパティの変更は、.watch(property, callback) メソッドを通してハンドリングされます。property に変更があると callback が呼び出されます。そして、監視しているオブジェクトのプロパティの新しい値、古い値、名前を取得することができます。

var propertyChangeHandler = function(newValue, oldValue, property, object){
  console.log("新しい値: ",newValue, "古い値: ",oldValue,
  "変更されたプロパティ: ", property, "監視しているオブジェクト: ", object);
};

View の利用

4.0 では、Map は 2D または 3D で表示することができます。それに併せ、マップの描画ロジックも修正され、マップとレイヤーの描画は View によって制御されるようになります。

View は 4.0 で導入されたコンセプトです。View は 2 つのタイプのうちのどちらか1つを使用します。

2D で表示する場合: MapView
3D で表示する場合: SceneView

View は 2D または 3D のデータを可視化するのに使用します。Map は実際のデータまたはデータを表示するためのレイヤーを含み、View はそれらのデータの表示を処理します。どのように、データを表示するかは、2D または 3D のどちらを使用するかによって異なります。View から Map を参照（例: view.map）できますが、Map から View を参照することはできません。重要なのは1つの Map が複数の View を利用することができる点です。

下記の構文は、作成した Map を 2D（MapView）と 3D（SceneView）で表示する方法を示しています。

2D（MapView）で表示する方法

function (Map, MapView){
map = new Map({
  basemap: "topo"
});
view = new MapView({
  container: "viewDiv",
  map: map,
  scale: 2400000
});
}

3D（SceneView）で表示する方法

function (Map, SceneView){
map = new Map({
  basemap: "topo"
});
view = new SceneView({
  container: "viewDiv",
  map: map,
  scale: 2400000
});

Map と Layer の仕様

Map と Layer には以下に挙げた重要な更新があります。

Map の layers に basemap は含まれません
2D と 3D の両方でマップの回転が可能になりました
グラフィックレイヤーは、マップのレイヤーコレクションの中のどこにでも追加することができます（3.x ではグラフィックレイヤーは他の形式のレイヤーよりも上に追加する必要がありました）
GroupLayer クラスが追加されました

モジュールとパッケージの更新

詳細は3.x/4.x 機能比較表（英語）を確認してください。以下に挙げた項目は、その中でも重要な更新です。

パッケージ名の変更（例: esri/dijit が esri/widgets に変更）
モジュール名の短縮（例: ArcGISTiledMapServiceLayer が TileLayer に変更）
モジュール名の統一（全てのモジュール名は大文字から始まります）
サポートクラスは、API リファレンスをより組織化するために support フォルダに移動しました(例: esri/layers/support, esri/tasks/support)。
esri/config の構成が変更され、 esriConfig.defaults のプロパティは esriConfig に移動しました。以下は、デフォルトで使用されるジオメトリサービスの設定方法の例です。
```
// 3.x
esriConfig.defaults.geometryService = new GeometryService("<ジオメトリ サービスのURL>");
```
```
// 4.0
esriConfig.geometryService = new GeometryService("<ジオメトリ サービスのURL>");
```

defaults.io オブジェクトは esriConfig.request に移動しました。

// 3.x
esriConfig.defaults.io.alwaysUseProxy = true;

// 4.0
esriConfig.request.alwaysUseProxy = true;

3 つの *-all レガシーモジュール（Editor-all, AttributeInspector-all, TemplatePicker-all）は削除されました。
各コンストラクタは JSON をサポートしません。代わりに、fromJSON() メソッド（例: Graphic.fromJSON() ）を使用してください。
FeatureLayer はグラフィックを保持しません。代わりに LayerView が FeatureLayer のフィーチャを表すグラフィックを描画します。

Web マップのサポート

4.x 以降でも、アプリケーションで Web マップを表示することができます。Web マップとの連携は部分的にサポートされています。これは、Web マップとの連携が API の現在のバージョンで利用可能な機能に依存するためです。例えば、まだ API で実装されていないタイプのレイヤー（WMS レイヤーなど）が含まれている場合、Web マップを表示することができません。API でサポートされているタイプのレイヤーのみを表示することができます。また、Web マップの編集はまだサポートされていないので注意してください。

AMD の利用

3.x では AMD とレガシーモジュールの両方を利用できましたが、4.0 からは、レガシーモジュールが廃止され、 AMD モジュールのみを利用できます。

廃止項目

Geocoder ウィジェットはバージョン 3.13 で非推奨となり、4.0 では提供されません。代わりに Search ウィジェットを使用してください。