トップへ戻る

インシデント レコードでフィーチャを更新 (Update Features With Incident Records) (犯罪分析と安全)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

既存のテーブルを更新するか、X および Y 座標の座標系または住所に基づいて、非空間テーブルをポイント フィーチャに変換するか、テーブルの新しいレコード情報または更新されたレコード情報で、既存のデータセットを更新します。

使用法

  • 入力テーブルのレコードが追加または更新される場合に、ポイント フィーチャクラス、ポイント フィーチャ レイヤー、またはテーブルが存在している必要があります。

  • コンピューターにサポートされた送信システム、またはこのツールのレコード管理システムからエクスポートされた、表形式のデータを使用できます。

  • このツールは入力として次のテーブル形式をサポートします。

    • ジオデータベース
    • dBASE (.dbf)
    • Microsoft Excel ワークシート (.xls および .xlsx)
    • メモリベースのテーブル
    • 区切り文字で区切られたファイル
      • カンマ区切りファイル (.csv、.txt、および .asc)
      • タブ区切りファイル (.tsv および .tab)
      • パイプ区切りファイル (.psv)

    区切りファイルの場合は、入力ファイルの 1 行目が出力テーブルのフィールド名として使用されます。 フィールド名には空白または特殊文字 ($、* など) を使用できません。入力ファイルの 1 行目に空白または特殊文字が含まれている場合は、エラーが発生します。

  • ArcGIS World Geocoding Service を使用してジオコーディング操作を行う場合は、ArcGIS Online 組織アカウントが必要であり、クレジットが消費されます。 ジオコーディング リクエストを最後まで完了するには、組織アカウントに十分なクレジットが必要です。

  • オプションの [無効なレコード テーブル] パラメーター値が作成されると、テーブルには、新しいまたは更新されたフィーチャとして処理されなかったレコードが含まれます。 完全な入力テーブル レコードが、[無効なレコード テーブル] パラメーター値および INV_REASON フィールドに追加されます。 INV_REASON フィールドには、レコードが新しいまたは更新されたフィーチャとして処理できなかった理由を特定するコードが含まれます。

    INV_REASON フィールドは、次のコードを持つ [無効なレコード テーブル] 値に追加されます。

    • NULL_ADDR - 入力テーブル レコードのすべての住所フィールドには、ゼロの値が含まれます。
    • NULL_ID - 入力テーブル レコードの入力 ID フィールドには、ゼロの値が含まれます。
    • NULL_XY - 入力テーブルの X および Y 座標の座標系フィールドには、ゼロの値が含まれます。
    • BAD_DATE - 入力テーブル レコードの入力日付は、ゼロか、有効な日付に変換できませんでした。
    • BAD_ADDR - 入力テーブル レコードの住所候補が一致しません。
    • BAD_FM - 値を出力フィールドに書き込めなかったため、入力テーブル レコードのフィールド マッピングが、正常に行われませんでした。 たとえば、テキスト値を数値フィールドに追加することはできません。また、テキスト値がフィールド長さよりも長い場合、そのテキスト値をテキスト フィールドに追加することはできません。 このコードが発生した場合、INV_FLD フィールドが [無効なレコード テーブル] 値に追加され、[ターゲット フィーチャ] 値に書き込めなかった値を含む [入力テーブル] 値がこのフィールドにリストされます。
    • DUP_ID - 入力テーブル レコードに重複した ID があり、ターゲット フィーチャに更新されませんでした。原因として、レコードが既存のレコードより古いか、新しいレコードが存在するためです。 これは、最終変更日付によって判断されます。 最終変更日付が使用されない場合、最大の OBJECTID 値によって判断されます。

    [無効なレコード テーブル] パラメーター値が入力されない場合は、invalid_records_<timestamp>.fid ファイルがテンポラリ ワークスペース環境に作成されます。 このファイルには、[ターゲット フィーチャ] パラメーターで追加または更新できなかった、それぞれの [入力テーブル] の OBJECTID 値が含まれます。

  • [既存のターゲット フィーチャを更新] パラメーターと [既存のフィーチャのジオメトリを更新] パラメーターの両方がオンのとき、[入力テーブル] パラメーター値の場所フィールドが [ターゲット フィーチャ] パラメーター値の場所フィールドと比較されて、ジオメトリが [ターゲット フィーチャ] パラメーター値で更新されるかどうかを判断します。 [ロケーション タイプ] が [住所] に設定される場合、[住所フィールド] の値が比較されます。 [入力テーブル] レコードと [ターゲット フィーチャ] パラメーター値の間に差が検出された場合、[入力テーブル] レコードの住所フィールドに基づき、[ターゲット フィーチャ] ジオメトリがジオコード位置で更新されます。 差が検出されない場合、[入力テーブル] レコードはジオコードされません。

  • [ターゲット フィーチャ] パラメーター値で指定されたレイヤーがフィーチャ サービス レイヤーである場合、[日付を UTC タイム ゾーンに変換] パラメーターを使用し、[入力テーブル] の日付値を UTC に変換するかどうかを指定します。 日付の値は、ローカル システムと同じタイム ゾーンにあると想定します。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力テーブル

レコードの場所を定義する X および Y 座標の座標系または住所を含む非空間テーブルまたはテーブル。

Table View
ターゲット フィーチャ

更新されるポイント フィーチャクラス、ポイント フィーチャ レイヤー、またはテーブル。

Feature Layer; Table View
ロケーション タイプ
(オプション)

X および Y 座標の座標系または住所を使用してフィーチャを作成するかどうかを指定します。

このパラメーターは、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

  • 座標—フィーチャは、入力レコードの X および Y 座標の座標系を使用して作成されます。
  • 住所—フィーチャは、ロケーターによって、入力レコードの住所を使用して作成されます。
String
X フィールド
(オプション)

X 座標 (経度) を含む入力テーブル内のフィールド。

このパラメーターは、[ロケーション タイプ] パラメーターが [座標] に設定され、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Field
Y フィールド
(オプション)

Y 座標 (緯度) を含む入力テーブル内のフィールド。

このパラメーターは、[ロケーション タイプ] パラメーターが [座標] に設定され、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Field
座標系
(オプション)

X 座標および Y 座標の座標系。

このパラメーターは、[ロケーション タイプ] パラメーターが [座標] に設定され、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Coordinate System
住所ロケーター
(オプション)

住所テーブルのジオコーディングに使用する住所ロケーター。

このパラメーターが ArcGIS World Geocoding Service を使用するように設定されていると、この操作はクレジットを消費します。

注意:

ローカルの住所ロケーターを使用する場合、ロケーター パスの末尾のロケーター名の後ろに .loc 拡張子を含めることはオプションです。

このパラメーターは、[ロケーション タイプ] パラメーターが [住所] に設定され、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Address Locator
住所タイプ
(オプション)

住所ロケーターで使用される住所フィールドを、入力住所テーブルのフィールドにどのようにマッピングするか指定します。

入力テーブルの 1 つのフィールドに完全な住所が格納される場合は、[単一フィールド] を指定します (303 Peachtree St NE, Atlanta, GA 30308 など)。 入力住所が、米国の一般的な住所に使用される複数のフィールド (Address、City、State、および ZIP など) に分割されている場合、[複数フィールド] を指定します。

このパラメーターは、[ロケーション タイプ] パラメーターが [住所] に設定され、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

  • 複数フィールド—住所は、複数のフィールドに分割されます。
  • 単一フィールド—住所は 1 つのフィールドに格納されます。
String
住所フィールド
(オプション)

入力テーブル フィールドで、住所ロケーターのロケーター住所フィールドに対応します。

一部のロケーターは、複数の入力住所フィールド (Address、Address2、Address3 など) をサポートしています。 この場合、住所コンポーネントは複数のフィールドに分割可能で、これらの住所フィールドはジオコーディング時に連結されます。 たとえば、3 つのフィールドに 100、Main st、Apt 140 がある場合や、2 つのフィールドに 100 Main st と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main st Apt 140 になります。

住所ロケーターで使用されるオプションの入力住所フィールドを入力住所テーブル内のフィールドにマッピングしない場合、フィールド名を空白のままにしてマッピングしないことを指定します。

このパラメーターは、[ロケーション タイプ] パラメーターが [住所] に設定されている場合にのみ有効です。

Value Table
無効なレコード テーブル
(オプション)

無効なレコードと関連する無効コードのリストを含む出力テーブルです。

Table
式
(オプション)

入力データセットのレコードのサブセットを選択するために使用する SQL 式。 複数の入力データセットを指定した場合、これらのデータセットはこの式を使用して評価されます。 入力データセットのレコードが式と一致しない場合、そのデータセットのレコードはターゲットに追加されません。

SQL 構文の詳細については、「ArcGIS で使用されるクエリ式の SQL リファレンス」をご参照ください。

SQL Expression
既存のターゲット フィーチャを更新
(オプション)

既存のレコードを [ターゲット フィーチャ] パラメーター値で更新するかどうかを指定します。

  • オン - [入力テーブル] パラメーター値のレコードが、[ターゲット フィーチャ] パラメーターで更新されます (存在する場合)。
  • オフ - [入力テーブル] パラメーター値のレコードが、[ターゲット フィーチャ] パラメーターに追加されます。 これがデフォルトです。
Boolean
マッチ フィールド
(オプション)

ID フィールド (1 つまたは複数) で、[入力テーブル] の値と [ターゲット フィーチャ] の値が一致しているかどうかを判断するために使用されます。

このパラメーターは、[既存のターゲット フィーチャを更新] パラメーターがオンになっている場合にのみ有効です。

Value Table
入力テーブル最終変更日付フィールド
(オプション)

[入力フィーチャ] レコードの最終変更日付を含むフィールドです。

日付と文字列のフィールド タイプがサポートされます。

このパラメーターは、[既存のターゲット フィーチャを更新] パラメーターがオンになっている場合にのみ有効です。

Field
ターゲット フィーチャ最終変更日付フィールド
(オプション)

[ターゲット フィーチャ] レコードの最終変更日付を含むフィールドです。

このフィールドは、日付フィールド タイプでなければなりません。

このパラメーターは、[既存のターゲット フィーチャを更新] パラメーターがオンになっている場合にのみ有効です。

Field
一致するフィーチャのみ更新
(オプション)

既存のレコードを更新のみするか、または既存のレコードを更新して新しいレコードを追加するかどうかを指定します。

  • オン - 既存のレコードが更新のみされます。
  • オフ - 既存のレコードが更新され、新しいレコードが追加されます。 これはデフォルトです。

このパラメーターは、[既存のターゲット フィーチャを更新] パラメーターがオンになっている場合にのみ有効です。

Boolean
既存のフィーチャのジオメトリを更新
(オプション)

既存のフィーチャのジオメトリを更新するかどうかを指定します。

  • オン - [入力テーブル] パラメーター値のジオメトリ情報が [ターゲット フィーチャ] パラメーター値のジオメトリと異なる場合、既存のレコードのジオメトリが更新されます。 これがデフォルトです。
  • オフ - 既存のレコードのジオメトリは更新されません。

このパラメーターは、[既存のターゲット フィーチャを更新] パラメーターがオンになっていて、[ターゲット フィーチャ] パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Boolean
フィールド マッチング タイプ
(オプション)

データを追加するために、入力テーブルのフィールドをターゲット フィーチャのフィールドと一致させる必要があるかどうかを指定します。

  • 入力フィールドはターゲット フィールドと一致する必要があります。—入力データセットのフィールドがターゲット データセットのフィールドに一致します。 一致しないフィールドは無視されます。 これがデフォルトです。
  • フィールド マップを使用してフィールドの違いをリコンサイル—入力データセットのフィールドをターゲット データセットのフィールドと一致させる必要はありません。 ターゲット データセットのフィールドと一致しない入力データセットのフィールドは、[フィールド マップ] パラメーターでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。
String
フィールド マップ
(オプション)

入力テーブルの属性フィールドのターゲット フィーチャへの転送方法またはマッピング方法を制御します。

このパラメーターは、[フィールド マッチング タイプ] パラメーターが [フィールド マップを使用してフィールドの違いをリコンサイル] に設定されている場合のみ有効です。

入力テーブルの値は、フィールドがあらかじめ定義されている既存のターゲット フィーチャに追加されるため、フィールド マップ内のフィールドのタイプを追加、削除、変更することはできません。 ただし、出力フィールドごとにマージ ルールを設定できます。

また、フィールド マップを使用して、複数のフィールドの値を 1 つの出力フィールドに結合することもできます。

Field Mappings
時間の形式

時間の値を含む入力フィールドの形式。 Short、Long、Float、Double、テキスト、または日付のいずれかのタイプになります。 ドロップダウン リストから標準の時間形式を選択するか、カスタムの形式を入力できます。

注意:

この形式の文字列では、大文字と小文字が区別されます。

  • 時間フィールドのデータ タイプが Date、Date Only、または Timestamp Offset の場合、時間形式は必要ありません。
  • 時間フィールドのデータ タイプが数値 (Short、Long、Float、Double、または Big Integer) の場合は、標準の数値時間形式のリストがドロップダウン リストに表示されます。
  • 時間フィールドのデータ タイプが文字列の場合は、標準の文字列時間形式のリストがドロップダウン リストに表示されます。 文字列フィールドの場合は、カスタム時間形式を指定することもできます。 たとえば、文字列フィールドに格納されている時間値は、yyyy/MM/dd HH:mm:ss などの標準形式である場合もあれば、dd/MM/yyyy HH:mm:ss などのカスタム形式である場合もあります。 カスタム形式では、午前または午後の指定子を指定することもできます。
  • ISO-8601 準拠の文字列では、yyyy-MM-ddTHH:mm:ss.s を入力形式として使用します。 この入力選択では、UTC 指定子 (Z) または UTC オフセット (±hh:mm) のいずれかを使用する入力を処理できます。
  • よく使用される形式を次に示します。
    • yyyy - 年を 4 桁で表します。
    • MM - 月を表し、月が 1 桁の場合は先頭にゼロが付きます。
    • MMM - 月を略称で表します。
    • dd - 日を表し、日が 1 桁の場合は先頭にゼロが付きます。
    • ddd - 曜日を略称で表します。
    • hh - 12 時間制で時を表し、時が 1 桁の場合は先頭にゼロが付きます。
    • HH - 24 時間制で時を表し、時が 1 桁の場合は先頭にゼロが付きます。
    • mm - 分を表し、分が 1 桁の場合は先頭にゼロが付きます。
    • ss - 秒を表し、秒が 1 桁の場合は先頭にゼロが付きます。
    • t - 1 文字の時間マーカー文字列 (A、P など)。
    • tt - 複数文字の時間マーカー文字列 (AM、PM など)。
    • unix_us - マイクロ秒単位の UNIX 時間。
    • unix_ms - ミリ秒単位の UNIX 時間。
    • unix_s - 秒単位の UNIX 時間。
    • unix_hex - 16 進数表記の UNIX 時間。

カスタム日付/時間形式の詳細

このパラメーターは、[入力テーブル最終変更日付] パラメーター値がテキスト フィールドで [ターゲット フィーチャ最終変更日付フィールド] パラメーター値が日付フィールドの場合、または [フィールド マップ] パラメーターの入力値がテキスト フィールドで出力値が日付フィールドの場合のみ有効です。

String
日付を UTC タイム ゾーンに変換
(オプション)

入力レコードの日付値をローカル システムのタイム ゾーンから協定世界時 (UTC) に変換するかどうかを指定します。

  • オン - 入力レコードの日付値を、ローカル システムのタイム ゾーンから UTC に変換します。 これがデフォルトです。
  • オフ - 入力レコードの日付値を、ローカル システムのタイム ゾーンのままにします。

このパラメーターは、[ターゲット フィーチャ] パラメーター値がフィーチャ サービス レイヤーの場合にのみ有効になります。

Boolean

派生した出力

ラベル説明データ タイプ
更新されたターゲット フィーチャ

更新されたターゲット データセット。

Feature Layer; Table View

arcpy.ca.UpdateFeaturesWithIncidentRecords(in_table, target_features, {location_type}, {x_field}, {y_field}, {coordinate_system}, {address_locator}, {address_type}, {address_fields}, {invalid_records_table}, {where_clause}, {update_target}, {match_fields}, {in_date_field}, {target_date_field}, {update_matching}, {update_geometry}, {field_matching_type}, {field_mapping}, time_format, {convert_local_time})
名前説明データ タイプ
in_table

レコードの場所を定義する X および Y 座標の座標系または住所を含む非空間テーブルまたはテーブル。

Table View
target_features

更新されるポイント フィーチャクラス、ポイント フィーチャ レイヤー、またはテーブル。

Feature Layer; Table View
location_type
(オプション)

X および Y 座標の座標系または住所を使用してフィーチャを作成するかどうかを指定します。

  • COORDINATES—フィーチャは、入力レコードの X および Y 座標の座標系を使用して作成されます。
  • ADDRESSES—フィーチャは、ロケーターによって、入力レコードの住所を使用して作成されます。

このパラメーターは、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

String
x_field
(オプション)

X 座標 (経度) を含む入力テーブル内のフィールド。

このパラメーターは、location_type パラメーターが COORDINATES に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Field
y_field
(オプション)

Y 座標 (緯度) を含む入力テーブル内のフィールド。

このパラメーターは、location_type パラメーターが COORDINATES に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Field
coordinate_system
(オプション)

X 座標および Y 座標の座標系。

このパラメーターは、location_type パラメーターが COORDINATES に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Coordinate System
address_locator
(オプション)

住所テーブルのジオコーディングに使用する住所ロケーター。

このパラメーターが ArcGIS World Geocoding Service を使用するように設定されていると、この操作はクレジットを消費します。

注意:

ローカルの住所ロケーターを使用する場合、ロケーター パスの末尾のロケーター名の後ろに .loc 拡張子を含めることはオプションです。

このパラメーターは、location_type パラメーターが ADDRESSES に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Address Locator
address_type
(オプション)

住所ロケーターで使用される住所フィールドを、入力住所テーブルのフィールドにどのようにマッピングするか指定します。

  • MULTI_FIELD_ADDRESS—住所は、複数のフィールドに分割されます。
  • SINGLE_FIELD_ADDRESS—住所は 1 つのフィールドに格納されます。

入力テーブルの 1 つのフィールドに完全な住所が格納される場合は、SINGLE_FIELD_ADDRESS を指定します (303 Peachtree St NE, Atlanta, GA 30308 など)。 入力住所が、米国の一般的な住所に使用される複数のフィールド (Address、City、State、および ZIP など) に分割されている場合、MULTI_FIELD_ADDRESS を指定します。

このパラメーターは、location_type パラメーターが ADDRESSES に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

String
address_fields
[address_fields,...]
(オプション)

入力テーブル フィールドで、住所ロケーターのロケーター住所フィールドに対応します。

一部のロケーターは、複数の入力住所フィールド (Address、Address2、Address3 など) をサポートしています。 この場合、住所コンポーネントは複数のフィールドに分割可能で、これらの住所フィールドはジオコーディング時に連結されます。 たとえば、3 つのフィールドに 100、Main st、Apt 140 がある場合や、2 つのフィールドに 100 Main st と Apt 140 がある場合、ジオコーディングのときは、どちらも 100 Main st Apt 140 になります。

住所ロケーターで使用されるオプションの入力住所フィールドを入力住所テーブル内のフィールドにマッピングしない場合、フィールド名を空白のままにしてマッピングしないことを指定します。

このパラメーターは、location_type パラメーターが ADDRESSES に設定されている場合のみ有効です。

Value Table
invalid_records_table
(オプション)

無効なレコードと関連する無効コードのリストを含む出力テーブルです。

Table
where_clause
(オプション)

入力データセットのレコードのサブセットを選択するために使用する SQL 式。 複数の入力データセットを指定した場合、これらのデータセットはこの式を使用して評価されます。 入力データセットのレコードが式と一致しない場合、そのデータセットのレコードはターゲットに追加されません。

SQL 構文の詳細については、「ArcGIS で使用されるクエリ式の SQL リファレンス」をご参照ください。

SQL Expression
update_target
(オプション)

既存のレコードを target_features パラメーター値で更新するかどうかを指定します。

  • UPDATE—in_table パラメーター値のレコードが、target_features パラメーター値で更新されます (存在する場合)。
  • APPEND—in_table パラメーター値のレコードが、target_features パラメーター値に追加されます。 これがデフォルトです。
Boolean
match_fields
[match_fields,...]
(オプション)

ID フィールド (1 つまたは複数) で、in_table の値と target_features の値が一致しているかどうかを判断するために使用されます。

このパラメーターは、update_target パラメーターが、UPDATE に設定されている場合のみ有効です。

Value Table
in_date_field
(オプション)

in_table レコードの最終変更日付を含むフィールドです。

日付と文字列のフィールド タイプがサポートされます。

このパラメーターは、update_target パラメーターが、UPDATE に設定されている場合のみ有効です。

Field
target_date_field
(オプション)

target_features レコードの最終変更日付を含むフィールドです。

このフィールドは、日付フィールド タイプでなければなりません。

このパラメーターは、update_target パラメーターが、UPDATE に設定されている場合のみ有効です。

Field
update_matching
(オプション)

既存のレコードを更新のみするか、または既存のレコードを更新して新しいレコードを追加するかどうかを指定します。

  • UPDATE_MATCHING_ONLY—既存のレコードが更新のみされます。
  • UPSERT—既存のレコードが更新され、新しいレコードが追加されます。 これがデフォルトです。

このパラメーターは、update_target パラメーターが、UPDATE に設定されている場合のみ有効です。

Boolean
update_geometry
(オプション)

既存のフィーチャのジオメトリを更新するかどうかを指定します。

  • UPDATE_GEOMETRY—in_table パラメーター値のジオメトリ情報が target_features パラメーター値のジオメトリと異なる場合、既存のレコードのジオメトリが更新されます。 これがデフォルトです。
  • KEEP_GEOMETRY—既存のレコードのジオメトリは更新されません。

このパラメーターは、update_target パラメーターが UPDATE に設定され、target_features パラメーター値がフィーチャクラスまたはレイヤーの場合にのみ有効になります。

Boolean
field_matching_type
(オプション)

データを追加するために、入力テーブルのフィールドをターゲット フィーチャのフィールドと一致させる必要があるかどうかを指定します。

  • AUTOMATIC—入力データセットのフィールドがターゲット データセットのフィールドに一致します。 一致しないフィールドは無視されます。 これがデフォルトです。
  • FIELD_MAP—入力データセットのフィールドをターゲット データセットのフィールドと一致させる必要はありません。 ターゲット データセットのフィールドと一致しない入力データセットのフィールドは、[フィールド マップ] パラメーターでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。
String
field_mapping
(オプション)

入力テーブルの属性フィールドのターゲット フィーチャへの転送方法またはマッピング方法を制御します。

このパラメーターは、field_matching_type パラメーターが FIELD_MAP に設定されている場合のみ有効です。

入力テーブルの値は、フィールドがあらかじめ定義されている既存のターゲット フィーチャに追加されるため、フィールド マップ内のフィールドのタイプを追加、削除、変更することはできません。 ただし、出力フィールドごとにマージ ルールを設定できます。

また、フィールド マップを使用して、複数のフィールドの値を 1 つの出力フィールドに結合することもできます。

Python では、FieldMappings クラスを使用して、このパラメーターを定義します。

Field Mappings
time_format

時間の値を含む入力フィールドの形式。 Short、Long、Float、Double、テキスト、または日付のいずれかのタイプになります。 ドロップダウン リストから標準の時間形式を選択するか、カスタムの形式を入力できます。

注意:

この形式の文字列では、大文字と小文字が区別されます。

  • 時間フィールドのデータ タイプが Date、Date Only、または Timestamp Offset の場合、時間形式は必要ありません。
  • 時間フィールドのデータ タイプが数値 (Short、Long、Float、Double、または Big Integer) の場合は、標準の数値時間形式のリストがドロップダウン リストに表示されます。
  • 時間フィールドのデータ タイプが文字列の場合は、標準の文字列時間形式のリストがドロップダウン リストに表示されます。 文字列フィールドの場合は、カスタム時間形式を指定することもできます。 たとえば、文字列フィールドに格納されている時間値は、yyyy/MM/dd HH:mm:ss などの標準形式である場合もあれば、dd/MM/yyyy HH:mm:ss などのカスタム形式である場合もあります。 カスタム形式では、午前または午後の指定子を指定することもできます。
  • ISO-8601 準拠の文字列では、yyyy-MM-ddTHH:mm:ss.s を入力形式として使用します。 この入力選択では、UTC 指定子 (Z) または UTC オフセット (±hh:mm) のいずれかを使用する入力を処理できます。
  • よく使用される形式を次に示します。
    • yyyy - 年を 4 桁で表します。
    • MM - 月を表し、月が 1 桁の場合は先頭にゼロが付きます。
    • MMM - 月を略称で表します。
    • dd - 日を表し、日が 1 桁の場合は先頭にゼロが付きます。
    • ddd - 曜日を略称で表します。
    • hh - 12 時間制で時を表し、時が 1 桁の場合は先頭にゼロが付きます。
    • HH - 24 時間制で時を表し、時が 1 桁の場合は先頭にゼロが付きます。
    • mm - 分を表し、分が 1 桁の場合は先頭にゼロが付きます。
    • ss - 秒を表し、秒が 1 桁の場合は先頭にゼロが付きます。
    • t - 1 文字の時間マーカー文字列 (A、P など)。
    • tt - 複数文字の時間マーカー文字列 (AM、PM など)。
    • unix_us - マイクロ秒単位の UNIX 時間。
    • unix_ms - ミリ秒単位の UNIX 時間。
    • unix_s - 秒単位の UNIX 時間。
    • unix_hex - 16 進数表記の UNIX 時間。

カスタム日付/時間形式の詳細

このパラメーターは、in_date_field パラメーター値がテキスト フィールドで target_date_field パラメーター値が日付フィールドの場合、または field_mapping パラメーターの入力値がテキスト フィールドで出力値が日付フィールドの場合のみ有効です。

このパラメーターは、update_target パラメーターが、UPDATE に設定されている場合のみ有効です。

String
convert_local_time
(オプション)

入力レコードの日付値をローカル システムのタイム ゾーンから協定世界時 (UTC) に変換するかどうかを指定します。

  • CONVERT—入力レコードの日付値を、ローカル システムのタイム ゾーンから UTC に変換します。 これがデフォルトです。
  • NO_CONVERT—入力レコードの日付値を、ローカル システムのタイム ゾーンのままにします。

このパラメーターは、target_features パラメーター値がフィーチャ サービス レイヤーの場合にのみ有効になります。

Boolean

派生した出力

名前説明データ タイプ
updated_target_features

更新されたターゲット データセット。

Feature Layer; Table View

コードのサンプル

UpdateFeaturesWithIncidentRecords の例 1 (Python ウィンドウ)

次のスクリプトは、イミディエイト モードで UpdateFeaturesWithIncidentRecords 関数を使用する方法を示しています。


import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           "COORDINATES",
                                           "Longitude",
                                           "Latitude",
                                           4326)
UpdateFeaturesWithIncidentRecords の例 2 (タンドアロン スクリプト)

次のスタンドアロン スクリプトは、UpdateFeaturesWithIncidentRecords 関数をスクリプトで使用する方法の例を示しています。

# Name: UpdateFeaturesWithIncidentRecords.py
# Description: Update the calls for service feature class with new updates from the records management system (RMS).

# Import script modules 
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:/data/city_pd.gdb"

# Address Field Pairs formatted as ["Locator Address Field Name", "Input Field Name"]
address_field_pairs = [
        ["Address", "locdesc"],
        ["Address2", ""],
        ["Address3", ""],
        ["Neighborhood", ""],
        ["City", "municipality"],
        ["Subregion", ""],
        ["Region", "state"],
        ["Postal", "zip5"],
        ["PostalExt", ""],
        ["CountryCode", ""]
    ]

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           location_type="ADDRESSES",
                                           address_locator="https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service",
                                           address_type="MULTI_FIELD_ADDRESS",
                                           address_fields=address_field_pairs,
                                           update_target="UPDATE",
                                           match_fields=[["callid", "callid"]],
                                           update_matching="UPSERT",
                                           update_geometry="UPDATE_GEOMETRY",
                                           field_matching_type="AUTOMATIC")

環境

現在のワークスペース

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック

  • 犯罪分析と安全ツールボックスの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報