概要
入力ライン フィーチャの標高断面図を返します。
使用法
オンライン ツールボックスに収容されているツールは、ホストしているデータと解析機能を ArcGIS Online で使用する ArcGIS Online ジオプロセシング サービスです。
このツールの出力は、各頂点の入力ライン フィーチャに沿って抽出した標高値から生成した、ポリライン フィーチャです。標高値はシェープ ジオメトリの Z 値として格納されます。距離値はシェープ ジオメトリの M 値として格納されます。[最大サンプリング距離] パラメーターを使用して、入力ポリラインの頂点をさまざまな密度で挿入できます。
入力ラインの最大数は、非同期断面図サービスの場合、1,000 となります。同期断面図サービスであれば 100 です。許容数を超える入力ラインが渡された場合、サービスはエラーを返すだけで何も実行しません。
返されるライン フィーチャの座標系は、入力ライン フィーチャと同じです。頂点の Z 値および M 値はメートル単位です。
[DEM 解像度] パラメーターが指定されていない場合、90 メートル解像度の SRTM データが使用されます。[最精細] を指定すると、サービスは入力ライン フィーチャ領域で最も細かい解像度を使うようになります。
[最大サンプリング距離] パラメーターが指定されていない場合、デフォルトのサンプリング距離を、入力ライン フィーチャで使用可能な頂点数に基づき計算します。入力ライン フィーチャ中の頂点数が 50 未満であれば、デフォルトのサンプリング距離は、入力ライン フィーチャの長さを 49 で割った値になります。頂点数が 50 以上 200 未満ならば、入力ライン フィーチャの長さを 199 で割った値です。頂点数が 200 以上 1,024 以下で、[最大サンプリング距離] パラメーターが指定されていない場合、入力ライン フィーチャに頂点を挿入せず、そのままにします。
サービスが返す標高値の最大数は、入力ライン数の 2,000 倍です。処理の結果、この最大数を超えてしまう場合、サービスはエラー メッセージを返し、何も実行しません。この場合、サンプリング距離の指定を大きくするか、または頂点数が少ないライン フィーチャを入力します。
さまざまな空間解像度およびエリアを網羅する標高ソースが複数用意されています。どの領域に対してもすべての解像度が揃っているとは限りません。入力フィーチャのいずれかの場所に、指定された DEM 解像度の標高ソースがなければ、ツールはエラー メッセージを返します。
Length Meters 出力フィールドには、輪郭線を測地的距離として計算した長さが含まれています。これは、データの座標系にかかわらず正しい長さになります。地図の投影歪みの効果で、shape_length 属性とは差があります。DEMResolution 出力フィールドには、ツールで使用されるソース DEM 解像度が記録されます。
計算で使用される DEM データ ソースを識別する 3 つの追加フィールド ( Product Name、Source、Source URL) が返されます。
構文
arcpy.agolservices.Profile(InputLineFeatures, {ProfileIDField}, {DEMResolution}, {MaximumSampleDistance}, {MaximumSampleDistanceUnits})| パラメーター | 説明 | データ タイプ |
InputLineFeatures | サーフェス入力上に断面図が作成されるライン フィーチャ。 | Feature Set |
ProfileIDField (オプション) | 断面図を対応する入力ライン フィーチャに関連付けるための一意の識別子。 | String |
DEMResolution (オプション) | 計算に用いるソース標高データの、およその空間解像度 (セル サイズ) を指定します。 解像度を表すキーワードは、デジタル標高モデルのおよその空間解像度を表します。多くの標高ソースは秒角単位で配布されています。キーワードは、わかりやすいよう、メートル単位の概算値をそのまま使っています。
| String |
MaximumSampleDistance (オプション) | 標高値のサンプリングに使用されるラインに沿った、最大サンプリング距離。 | Double |
MaximumSampleDistanceUnits (オプション) | [最大サンプリング距離] パラメーターの単位を指定します。
| String |
派生した出力
| 名前 | 説明 | データ タイプ |
| OutputProfile | 入力ライン フィーチャの出力標高断面図。 | フィーチャ セット |