チュートリアル: arcpy.mapping を使用した基本的な Web マップの印刷/エクスポート—ArcMap

ベクターデータの取得
Python スクリプトの作成
Python スクリプトツールの作成
ツールの実行
結果の公開
ArcGIS API for JavaScript のコードサンプル
Web アプリケーションの実行

複雑度:: 中級
データ要件:: ArcGIS.com

このチュートリアルでは、エンドユーザーが対象領域に移動して [Print] ボタンをクリックすることができる Web GIS アプリケーションを構築します。出力は、サービスレイヤーのベクター出力を含む、印刷に適した PDF ドキュメントです。

すぐに使用できるPrintingTools サービスと ArcGIS API for JavaScript のクライアント印刷ウィジェットを使用して Web アプリケーションからエクスポートすると、サービスレイヤーの高品質な画像を出力できます。ただし、ベクター出力が必要になることがあります。たとえば、ベクター PDF 出力は、PDF 表示アプリケーションでレイヤー表示の切り替え、フィーチャ属性の表示、およびマップ座標の表示をサポートします。これから構築する Web アプリケーションでは、World Topographic ベースマップサービスと同等のベクターを出力します。World Topographic ベースマップサービスのベクターの小さな領域のサブセットは公開されています。

下の図に、構築する Web アプリケーションを示します。

この Web アプリケーションの [Print] ボタンに実装されているコードは、ArcGIS 10.1 for Server 以降で使用可能な、ArcGIS API for JavaScript[Print Task] を使用します。ジオプロセシングサービスとして公開され、[Print Task] が使用する Python スクリプトを作成します。この Python スクリプトは、arcpy.mapping モジュールの ConvertWebMapToMapDocument 関数を使用して、完全な状態の Web マップをテンプレートマップドキュメントに挿入します。テンプレートには、マップサービス内の選択可能なすべてのレイヤーと同等のベクターが含まれます。arcpy.mapping モジュールは、テンプレートマップドキュメントに段階分けされたローカルベクターデータを残してサービスレイヤーを削除し、PDF にエクスポートする機能も備えています。

[Print] ボタンをクリックすると、サービスレイヤーの画像ではなく、ローカルベクターデータを含む印刷に適した PDF ドキュメントが出力されます。

このチュートリアルを完了するには、arcpy.mapping モジュール、ArcGIS API for JavaScript、ArcGIS for Desktop、および ArcGIS for Server に習熟している必要があります。次の Web アプリケーションのヘルプトピックを読み、印刷についても熟知する必要があります。

ベクターデータの取得

マップドキュメントテンプレートで使用するベクターデータを含む圧縮ファイルをダウンロードできます。これを実行する前に、フォルダー構造が存在し、そこで ArcGIS for Server が、Web アプリケーションで使用されるテンプレートマップドキュメントとテンプレートデータを参照できることを確認する必要があります。このチュートリアルは、ArcGIS for Server に登録されたフォルダーがあることを前提にしています。ArcGIS for Server へのデータ登録の詳細については、以下をご参照ください。

新しい空の ArcMap セッションを開きます。
[カタログ] ウィンドウで、登録済みフォルダーを参照します。登録済みフォルダー内に、「BasicTutorial」という名前の新しいフォルダーを作成します。
Web ブラウザーで、World Topographic Map Template のダウンロードページに移動します。
[開く] → [ダウンロード] ボタンをクリックして、World Topographic Map Template の圧縮ファイルをコンピューターにダウンロードします。
メッセージが表示されたら、[名前を付けて保存] を選択し、圧縮ファイルを登録済みフォルダー内の BasicTutorial フォルダーに保存します。
ArcMap で、[パッケージの抽出 (ExtractPackage)] ツールを開きます。このツールは、圧縮されたマップテンプレートを登録済みフォルダーに解凍します。in_package パラメーターは、ダウンロードした圧縮ファイルになっています。output_folder パラメーターは、登録済みフォルダー内で BasicTutorial フォルダーになっています。
[OK] ボタンをクリックして、このツールを実行します。
登録済みフォルダーは、次の図のようになります。

注意:
上のスクリーンキャプチャでは、登録済みフォルダーの名前は、MyDataStore です。登録済みフォルダーには、任意の名前を付けることができます。

これで、WorldTopo_103Templatev2_288k_to_1k.mxd マップドキュメントを Web アプリケーションで使用する準備が整いました。

Python スクリプトの作成

カスタムジオプロセシング印刷サービスとして使用する Python スクリプトを作成します。

カスタムジオプロセシング印刷サービスの Python スクリプトは、ConvertWebMapToMapDocument 関数を実行します。この関数は、印刷またはエクスポートする Web マップ (JSON 形式) をマップドキュメントに変換します。次に、このスクリプトは、JSON Web マップ内のサービスレイヤーに対応するベクターレイヤーを残して、出力マップドキュメント内のサービスレイヤーを削除します。JSON Web マップには、Web アプリケーションのマップの範囲も含まれています。最後に、このスクリプトは、マップドキュメントを PDF ドキュメントにエクスポートします。

任意のPython IDE(ArcGIS for Desktop に付属する IDLE など) を開きます。
以下のコードをコピーして新しい Python スクリプトに貼り付けます。

import arcpy
import os
import uuid

# Input WebMap json
Web_Map_as_JSON = arcpy.GetParameterAsText(0)

# The template location in the server data store
templateMxd = r"\\MyComputer\MyDataStore\BasicTutorial\v103\WorldTopo_103Templatev2_288k_to_1k.mxd"
   
# Convert the WebMap to a map document
result = arcpy.mapping.ConvertWebMapToMapDocument(Web_Map_as_JSON, templateMxd)
mxd = result.mapDocument

# Reference the data frame that contains the webmap
# Note: ConvertWebMapToMapDocument renames the active dataframe in the template_mxd to "Webmap"
df = arcpy.mapping.ListDataFrames(mxd, 'Webmap')[0]

# Remove the service layer
# This will just leave the vector layers from the template
for lyr in arcpy.mapping.ListLayers(mxd, data_frame=df):
    if lyr.isServiceLayer:
        arcpy.mapping.RemoveLayer(df, lyr)
        
# Use the uuid module to generate a GUID as part of the output name
# This will ensure a unique output name
output = 'WebMap_{}.pdf'.format(str(uuid.uuid1()))
Output_File = os.path.join(arcpy.env.scratchFolder, output)

# Export the WebMap
arcpy.mapping.ExportToPDF(mxd, Output_File) 

# Set the output parameter to be the output file of the server job
arcpy.SetParameterAsText(1, Output_File)

# Clean up - delete the map document reference
filePath = mxd.filePath
del mxd, result
os.remove(filePath)

templateMxd 変数の値を、テンプレートマップドキュメントが含まれる登録済みフォルダー内のフォルダーへの UNC パスに変更します。

Python スクリプトを保存します。スクリプトの名前は BasicTutorial.py にします。このスクリプトを、登録済みフォルダー内の「WebApp」という名前のフォルダーに保存します。

Python スクリプトツールの作成

BasicTutorial.py スクリプトを実行するカスタムジオプロセシングツールを作成します。

ArcMap の [カタログ] ウィンドウで、登録済みフォルダーディレクトリ内の WebApp フォルダーを参照します。
WebApp フォルダーを右クリックして、[新規作成] > [ツールボックス] の順にクリックします。ツールボックスに、「BufferService」という名前を付けます。
[BasicTutorial] ツールボックスを右クリックして、[アイテム説明] をクリックします。
[アイテム説明] ダイアログボックスで、任意のテキストを使用して[タグ] アイテムと [サマリー] アイテムに入力します。必要に応じて、他のアイテム説明も入力します。
[保存] をクリックして [アイテム説明] ダイアログボックスを終了します。
[カタログ] ウィンドウで [BasicTutorial] ツールボックスを右クリックし、[追加] > [スクリプト] の順にクリックします。
[スクリプトの追加] ダイアログボックスで、[名前] と [ラベル] の両方に「BasicTutorial」と入力します。
[次へ] をクリックします。
スクリプトファイルを選択するために、登録済みフォルダー内の WebApp フォルダーを参照して、BasicTutorial.py を選択します。
[次へ] をクリックします。
2 つのパラメーターをスクリプトツールに追加する必要があります。
1. 最初のパラメーターは Web_Map_as_JSON になります。このパラメーターには、Web アプリケーションに表示されている、エクスポートするマップの状態を表す JSON 表現を入力します。プロパティの値を、次の図の値に合わせてください。
2. 2 つ目のパラメーターは、Output_File で、これが作成される出力ファイルです。プロパティの値を、次の図の値に合わせてください。
  
  注意:
  Web_Map_as_JSON および Output_File の各パラメーター名は、ArcGIS Web API の [Print Task] のツールシグネチャに一致するように、示されたとおりに正確に記述する必要があります。
3. [スクリプトの追加] ダイアログボックスで [完了] をクリックします。
BasicTutorial スクリプトツールを右クリックして、[アイテム説明] をクリックします。
[アイテム説明] ダイアログボックスで、任意のテキストを使用して [タグ] アイテムと [サマリー] アイテムに入力します。[アイテム説明] ダイアログボックスの [構文] セクションにある、2 つのパラメーターに対応する [ダイアログの説明] にも、任意のテキストを使用してすべて入力します。必要に応じて、他のアイテム説明も入力します。

ツールの実行

ツールを正常に実行して、ArcGIS for Server で公開できる結果を [結果] ウィンドウに作成する必要があります。

[カタログ] ウィンドウで BasicTutorial スクリプトツールを右クリックし、[開く] をクリックします。
Web_Map_as_JSON 入力パラメーターを空白のままにします。

ヒント:
公開する目的の場合、ArcGIS API for JavaScript が Web アプリケーションで JSON Web マップを提供することになるため、Web_Map_as_JSON 入力パラメーターを空白のままにすることができます。空白の入力によってエラーが発生しない方法で Python スクリプトが記述されている場合に限り、Web_Map_as_JSON 入力パラメーターを空白のままにすることができます。たとえば、スクリプトが Web マップレイヤーを名前で検索しない場合です。
[OK] をクリックします。ツールの実行が終わるのを待ちます。

これで、結果をジオプロセシングサービスとして公開する準備が整いました。

結果の公開

ジオプロセシングサービスの公開に慣れていない場合は、以下をご参照ください。

[結果] ウィンドウを開きます。
[現在のセッション] を展開します。
[BasicTutorial] の結果を右クリックし、[共有] > [ジオプロセシングサービス] の順にクリックします。
[サービスを公開] をオンにします。
[次へ] をクリックします。
ArcGIS for Server コンピューターへの公開接続または管理接続を選択します。
[次へ] をクリックします。
[次へ] をクリックします。
[続行] をクリックします。
[サービスエディター] ダイアログボックスの右上隅にある [公開] をクリックします。

これで、ジオプロセシングサービスを ArcGIS API for JavaScript で使用する準備が整いました。

ArcGIS API for JavaScript のコードサンプル

次のコードサンプルを使用して、Web アプリケーションを作成します。

下に示す ArcGIS API for JavaScript のサンプルコードでは、URL を前述の手順で作成したジオプロセシングサービスに変更して、使用しているサーバー名に一致するようにします。その URL は、次の行で参照されています。

var printUrl = "http://MyServer:6080/arcgis/rest/services/BasicTutorial/GPServer/BasicTutorial";

BasicTutorial.html のコード

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
    <title>Webmap Printing</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <meta http-equiv="X-UA-Compatible" content="IE=7,IE=9" />
    <meta name="viewport" content="initial-scale=1, maximum-scale=1,user-scalable=no"/>
    <link rel="stylesheet" type="text/css" href="http://serverapi.arcgisonline.com/jsapi/arcgis/3.0/js/dojo/dijit/themes/claro/claro.css">
    <script src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=3.0"></script>
    <script type="text/javascript" language="Javascript">
      dojo.require("esri.map");
      dojo.require("esri.tasks.PrintTask");
      var printTask, params;

      function init() {
        // set the extent of the web app to same extent as the template map document
        var startExtent = new esri.geometry.Extent({
          "xmin" : -13043333,
          "ymin" : 3836078,
          "xmax" : -13030585,
          "ymax" : 3853683,
          "spatialReference" : {
            "wkid" : 102100
          }
        });

        var map = new esri.Map("map", {
          extent : startExtent
        });

        // add tiled map service to webmap
        var tiledUrl = "http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer";
        var tiledLayer = new esri.layers.ArcGISTiledMapServiceLayer(tiledUrl);
        map.addLayer(tiledLayer);
        var printUrl = "http://MyServer:6080/arcgis/rest/services/BasicTutorial/GPServer/BasicTutorial";
        printTask = new esri.tasks.PrintTask(printUrl, {
          async : true
        });
        params = new esri.tasks.PrintParameters();
        params.map = map;
      }

      function print() {
        var ptemplate = new esri.tasks.PrintTemplate();
        // use the extent of the webmap in the output PDF
        ptemplate.preserveScale = false;
        params.template = ptemplate;
        printTask.execute(params, printComplete);
      }

      function printComplete(result) {
        window.open(result.url);
      }


      dojo.addOnLoad(init);

    </script>
  </head>
  <body class="claro">
    <input type="button" id="print" value="Print" onclick="print();"/>
    <div id="map" style="width:1000px; height:600px; border:1px solid #000;"></div>
  </body>
</html>

Web アプリケーションの実行

前述した手順で作成した Web アプリケーションを実行します。Web アプリケーションを実行する手順については、必要に応じて ArcGIS API for JavaScript のドキュメントをご参照ください。下の図は、Web アプリケーションのスクリーンキャプチャです。

対象領域を拡大して、[Print] ボタンをクリックします。しばらくして、出力 PDF ドキュメントが自動的にポップアップ表示されます。この出力は、サービスレイヤーの画像ではなく、複数のレイアウトテンプレートに段階分けされたローカルベクターデータを含む、印刷に適した PDF ドキュメントです。この出力のサンプルを下に示します。

これで、arcpy.mapping チュートリアルを使用した基本的な Web マップの印刷およびエクスポートの説明は終了です。さらに高度なシナリオについては、「チュートリアル: arcpy.mapping を使用した高度な Web マップの印刷/エクスポート」をご参照ください。

ベクター データの取得