esri_maplayer_add (AutoLISP)

指定されたサービス プロパティを使用して現在のドローイングにマップ レイヤーまたはイメージ レイヤーを追加します。 このレイヤーは、追加先となったドローイングの現在の座標系を使用します。 座標系が含まれていないドローイングにレイヤーを追加すると、そのドローイングはレイヤーから座標系を継承します。

構文

(esri_maplayer_add url service_properties)

引数

• url | 文字列 | 必須 | ArcGIS のマップ レイヤーかイメージ レイヤーへの有効なパス。
• service_properties | 関連リスト |オプション | ドット ペア形式によるマップ サービス プロパティの関連リスト。次のように定義します。

  関連ラベル	値のタイプ	値の説明	必須またはオプション
  "TRANSPARENCY"	Integer	マップに適用する画像透過率: {0-99: zero is opaque} (デフォルト = 30)	オプション

使用例

透過率が 70% のマップ レイヤーかイメージ レイヤーを指定された URL から追加することを試行します。

(esri_maplayer_add "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer"
  (list
  (cons "TRANSPARENCY" 70)
  )
)

使用例の結果

マップ レイヤーを追加し、新しいマップ レイヤー インデックス番号を含むリストを返します。

(1)

戻り値

この関数は値を返します。

• 正常に実行された場合、新しいマップ レイヤー インデックス番号を含むリストが返されます。
• 実行に失敗した場合、nil の最初の値を含むリスト、キー値 Error を含む関連リスト、文字列としての関連エラー メッセージ (nil ( "Error" . "<message>")) が順番に返されます。

失敗した場合の戻り値

失敗の戻り値が返された理由として、次のようなことが考えられます。

• (nil ("Error" . "Invalid URL"))

  指定された URL が無効です。

• (nil ("Error" . "Error adding layer."))

  指定された URL からマップ レイヤーを追加できませんでした。

• (nil ("Error" . "Missing required argument."))

  -1 つ以上の必須引数が指定されていません。