インストール ガイド

JavaScriptライブラリをインストールする前に利用規約をご覧ください。 ArcGIS Maps SDK for JavaScript へのアクセスには、CDN(Content Delivery Network)上のホスト バージョンを使用することをお勧めします。

<link rel="stylesheet" href="https://js.arcgis.com/4.33/esri/themes/light/main.css" />
<script src="https://js.arcgis.com/4.33/"></script>

ただし、API のコピーを自分の Web サーバー上でローカルにホストしたい場合もあります。 詳細については、“AMD モジュールをローカルでホストできますか?” をお読みください。 FAQ トピックをご覧ください。

ライブラリーのダウンロード

ライブラリとヘルプ ドキュメントは ArcGIS Maps SDK for JavaScript リファレンスの Downloads ページからダウンロードできます。ダウンロードしたいバージョンの [API] ボタンをクリックするとダウンロードが開始します。

※ バージョンによってはインストール方法が本手順とは異なる場合があります。詳しくはダウンロード フォルダ内にあります install.html をご参照ください。

[Documentation] ボタンをクリックすると https://developers.arcgis.com/javascript/ で公開されているヘルプ ドキュメントとサンプル一式をダウンロードできます。

ArcGIS Maps SDK for JavaScript ライブラリーのインストール

Windows オペレーティング システムに ArcGIS Maps SDK for JavaScript ライブラリーをインストールする手順と、Unix/Linux ベースのシステムに ArcGIS Maps SDK for JavaScript ライブラリをインストールする手順は、オペレーティング システムと Web サーバー インスタンスに固有の Web サーバー ソフトウェアを構成する必要があるという事実を除いて、概念的に同じです。

Apache HTTP サーバー

これらの手順では、ArcGIS Maps SDK for JavaScript ライブラリーを Apache HTTP サーバー上の次の場所 https://www.example.com/javascript/api/4.33/ (/var/www/html/javascript/api/4.33) にインストールすることを前提としています。www.example.com は、Web サイトの完全修飾ドメイン名トップ レベル ドメインの組み合わせです。

インターネット インフォメーション サービス(IIS)

この手順では、Windows® Server の インターネット インフォメーション サービス (IIS) 上の次の場所 https://www.example.com/javascript/api/4.33/ (C:\Inetpubwwwroot\javascript\api\4.33) に ArcGIS Maps SDK for JavaScript ライブラリをインストールするものとします。www.example.com は、Web サイトの完全修飾ドメイン名トップ レベル ドメインの組み合わせです。

ArcGIS Maps SDK for JavaScript ライブラリーは、その全体を Web サーバー ディレクトリーにコピーできます。ArcGIS Maps SDK for JavaScript のダウンロードから、\arcgis_js_v433_api\arcgis_js_api\javascript\4.33\ ディレクトリーとその中のすべてのファイルを Web サーバーにコピーします。この例では、ファイルは次の場所にコピーしています。C:\Inetpub\wwwroot\javascript\api\4.33\

必要条件

ArcGIS Maps SDK for JavaScript ライブラリおよびドキュメントのデフォルトのホスティング構成は、いずれも HTTPS です。

インストールのテスト

次のサンプルは、ダウンロード版の ArcGIS Maps SDK for JavaScript に含まれています。 ダウンロードした ArcGIS Maps SDK for JavaScript から /arcgis_js_v433_api/arcgis_js_api/javascript/4.33/ とそのすべてのコンテンツを Web サーバーにコピーした後、サポート対象の Web ブラウザーでアプリケーション https://www.example.com/javascript/api/4.33/index.html を開くことで API をテストできます。

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no" />
    <title>Test local installation of ArcGIS Maps SDK for JavaScript</title>
    <style>
      html,
      body,
      #viewDiv {
        padding: 0;
        margin: 0;
        height: 93%;
        width: 100%;
      }
    </style>

    <link rel="stylesheet" href="./esri/themes/light/main.css" />
    <script src="./init.js"></script>

    <script type="module">
      const [Basemap, TileLayer, Map, SceneView] = await $arcgis.import([
        "@arcgis/core/Basemap.js",
        "@arcgis/core/layers/TileLayer.js",
        "@arcgis/core/Map.js",
        "@arcgis/core/views/SceneView.js",
      ]);

      // --------------------------------------------------------------------
      // If you do not have public internet access, change the layer URL to
      // point to your own locally accessible cached service.
      // --------------------------------------------------------------------
      const layer = new TileLayer({
        url: "https://services.arcgisonline.com/arcgis/rest/services/World_Street_Map/MapServer",
      });
      const customBasemap = new Basemap({
        baseLayers: [layer],
        title: "My Basemap",
      });
      const myMap = new Map({
        basemap: customBasemap,
      });
      const view = new SceneView({
        container: "viewDiv",
        map: myMap,
      });

      checkThisOne("./esri/views/3d/environment/resources/stars.wsv", "wsv mimetype");
      checkThisOne("./esri/t9n/basemaps.json", "json mimetype");
      checkThisOne("./esri/themes/base/icons/fonts/CalciteWebCoreIcons.ttf", "ttf mimetype");
      checkThisOne("./esri/themes/base/icons/fonts/CalciteWebCoreIcons.woff", "woff mimetype");

      function checkThisOne(url, desc) {
        fetch(url, {
          method: "HEAD",
        })
          .then(function (response) {
            if (response.ok) {
              logDiv.innerHTML += "* OK: " + desc + "<br/>";
              if (response.status !== 200) {
                logDiv.innerHTML += "&nbsp;&nbsp;&nbsp;&nbsp;status: " + response.status + "<br/>";
              }
              return response.blob();
            } else {
              // response not ok
              logDiv.innerHTML +=
                "* HTTP error " +
                response.status +
                ' for <a href="' +
                url +
                '">' +
                url +
                "</a><br/>";
              alert("Problem accessing " + desc);
            }
          })
          .catch(function (error) {
            logDiv.innerHTML += '* BAD: <a href="' + url + '">' + url + "</a><br/>";
          });
      }
    </script>
  </head>

  <body>
    <div id="viewDiv"></div>
    <div id="logDiv"></div>
  </body>
</html>

以下のスクリーンショットのような結果が表示されます。(X.YZの部分は4.33となります。)