LocationAllocation input data types

The input data types that can be specified when performing a location-allocation analysis are described below.

Facilities

解析中に選択される 1 つまたは複数の施設を指定します。この解析は、指定された解析タイプおよび基準に従って最も効率的な方法で需要を割り当てるのに最適な施設を特定します。

The data type supports the following fields:

FieldDescriptionData type

Name

施設の名前。施設がソリューションの一部である場合、名前は出力アロケーション ラインの名前に含まれます。

String

FacilityType

施設が候補施設、必須施設、競合施設のいずれであるかを指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (候補) - ソリューションに含めることができる施設。
  • 1 (必須) - ソリューションに含めなければならない施設。
  • 2 (競合) - 自社の施設から需要を除去する可能性のあるライバル施設。競合施設は、[市場シェアの最大化] 解析タイプと [目標市場シェア] 解析タイプのみで使用されます。他の解析タイプでは無視されます。

Short

Weight

施設に対する相対的なウェイトの割り当て。これは、1 つの施設のもう 1 つの施設と比較した場合の魅力、利用価値、または傾向を格付けするのに使用されます。

たとえば、ある施設に対して値を 2.0 に設定すると、2 対 1 の割合で、もう 1 つの施設ではなくその施設で買い物をすることを好む顧客を獲得できます。施設のウェイトに影響する可能性のある要因には、面積、周辺地域、建物の築年数などがあります。Weight 値 (1 を除く) は、[市場シェアの最大化] 解析タイプと [目標市場シェア] 解析タイプのみで考慮されます。他の解析タイプでは無視されます。

Double

Capacity

Capacity フィールドは [カバー容量の最大化] 解析タイプに固有のプロパティで、他の解析タイプでは無視されます。

Capacity は、施設が供給可能な加重需要の量を指定します。施設の容量を超える需要は、施設のデフォルトの計測カットオフの範囲内であっても、その施設には割り当てられません。

Any value assigned to the Capacity field overrides the overall default set for the analysis using the defaultCapacity property of the analysis object.

Double

CurbApproach

車両が施設に到着する方向または施設から出発する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (車両の両側) - 施設には車両の左右どちら側からでも訪れることができます。
  • 1 (車両の右側) - 施設には車両の右側から到着または出発します。これは、通常、乗客が乗降するためにバス停が右側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 2 (車両の左側) - 施設には車両の左側から到着または出発します。車両が施設に到着するときおよび施設から出発するとき、アプローチは車両の左側である必要があります。これは、通常、乗客が乗降するためにバス停が左側にある状態で到着する必要があるバスなどの車両に使用されます。

CurbApproach 属性は、米国の右側通行の標準と英国の左側通行の標準の両方に対応するように設計されています。まず、施設が車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらから施設に到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、施設に到着するときに、車両とインシデントの間に交通レーンがない方がいい場合は、米国では 1 (車両の右側) を選択し、英国では 2 (車両の左側) を選択します。

Short Integer

Bearing

ポイントが移動している方向。単位は度で、北を基準に時計回りに測定されます。このフィールドは BearingTol フィールドと組み合わせて使用されます。

通常、方位データは、GPS 受信機を備えたモバイル デバイスから自動的に送信されます。歩行者や車両などの移動している入力場所を読み込んでいる場合は、方位データを含めてみてください。

このフィールドを使用すると、たとえば、車両が交差点や高架の近くにいる場合に、ロケーションが間違ったエッジに追加されるのを避けることができます。方位は、ツールがポイントを道路のどちら側に配置するかを決定する際にも役立ちます。

方位と方位許容値の詳細

Double

BearingTol

方位許容値は、Bearing フィールドを使用して移動ポイントをエッジに配置するときに、許容される方位の範囲を作成します。Bearing フィールドの値が、エッジの方位許容値から生成される許容範囲内にある場合は、ポイントをその場所にネットワーク ロケーションとして配置できます。許容範囲から外れている場合は、次に近いエッジの最も近いポイントが評価されます。

単位は度で、デフォルト値は 30 です。値は 0 より大きく 180 未満でなければなりません。値が 30 の場合、Network Analyst がネットワーク ロケーションをエッジに追加しようとすると、方位値の許容範囲がエッジの両側 (左と右) に 15 度ずつ、どちらもエッジのデジタイズされた方向に生成されます。

方位と方位許容値の詳細

Double

NavLatency

このフィールドは、BearingBearingTol の値が存在する場合にのみ、解析処理で使用されます。ただし、BearingBearingTol の値が存在する場合でも、NavLatency 値の入力は任意です。NavLatency は、移動中の車両からサーバーに GPS 情報が送信されてから、車両のナビゲーション デバイスが処理されたルートを受信するまでの予想経過時間を示します。

NavLatency の時間単位は、解析オブジェクトの timeUnits プロパティで指定された単位と同じです。

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

これらのプロパティを組み合わせて、オブジェクトが配置されているネットワーク上のポイントを表します。

Demand point

1 つまたは複数の需要地点を指定します。ここで指定する需要地点に対して提供されるサービスに基づいて、最適な施設が解析によって特定されます。

一般的に、需要地点とは、施設が提供する商品とサービスを必要とする人または物を表すロケーションのことです。需要地点は、その内部に居住している住民の数によって加重された郵便番号重心であったり、予測されるこれらの住民による消費の量によって加重された郵便番号重心であったりします。需要地点は、ビジネス顧客を表すこともあります。ビジネスに供給する在庫の回転率が高い場合、これらのビジネスのウェイトは、回転率が低いビジネスよりも重くなります。

The data type supports the following fields:

FieldDescriptionData type

Name

需要地点の名前。需要地点がソリューションの一部である場合、名前は出力アロケーション ラインの名前に含まれます。

String

GroupName

需要地点が属しているグループの名前。このフィールドは、[カバー容量の最大化]、[目標市場シェア]、および [市場シェアの最大化] の各解析タイプでは無視されます。

複数の需要地点が 1 つのグループ名を共有している場合、解析はそのグループに属するすべての需要地点を同じ施設に割り当てます。距離カットオフなどの制約により、グループ内の需要地点のいずれかが同じ施設に到達できない場合、いずれの需要地点も割り当てられません。

String

Weight

需要地点の相対加重。ウェイトの値が 2.0 であれば、その需要地点は値が 1.0 の需要地点よりも 2 倍重要であることを示します。たとえば需要地点が世帯を示す場合、ウェイトは各世帯の人数を示します。

Double

Cutoff

指定された施設の需要地点の検索を停止するインピーダンス値。需要地点は、ここに示される値を越える施設には割り当てられません。

この属性では、需要地点ごとにカットオフ値を指定できます。たとえば、施設に到達するために移動してもいとわない距離が農村部の住民の場合は最大 10 マイルであるのに対し、都市部の住民の場合は最大 2 マイルであるとします。この振舞いは、農村部のすべての需要地点の Cutoff 値を 10 に設定し、都市部の需要地点の Cutoff 値を 2 に設定することでモデリングできます。

A value for this attribute overrides the default set for the analysis using the defaultImpedanceCutoff property.

If the travel mode set for the analysis uses a time-based impedance attribute, the values are interpreted to be in the units specified by the timeUnits property. If the travel mode set for the analysis uses a distance-based impedance attribute, the values are interpreted to be in the units specified by the distanceUnits property. If the travel mode set for the analysis uses an impedance attribute that is neither time based nor distance based, the values are interpreted to be in unknown units.

The default value is Null, which results in using the default value set by the defaultImpedanceCutoff property for all the demand points.

Double

ImpedanceTransformation

Allows you to override the default value set for the analysis by the decayFunctionType property of the analysis object.

Long

ImpedanceParameter

Allows you to override the default value set for the analysis by the decayFunctionParameterValue property of the analysis object.

Double

CurbApproach

車両が需要地点に到着する方向または需要地点から出発する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (車両の両側) - 需要地点には車両の左右どちら側からでも訪れることができます。
  • 1 (車両の右側) - 需要地点には車両の右側から到着または出発します。車両が需要地点に到着するときおよび需要地点から出発するとき、アプローチは車両の右側である必要があります。これは、通常、乗客が乗降するためにバス停が右側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 2 (車両の左側) - 需要地点には車両の左側から到着または出発します。車両が需要地点に到着するときおよび需要地点から出発するとき、アプローチは車両の左側である必要があります。これは、通常、乗客が乗降するためにバス停が左側にある状態で到着する必要があるバスなどの車両に使用されます。

CurbApproach 属性は、米国の右側通行の標準と英国の左側通行の標準の両方に対応するように設計されています。まず、需要地点が車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらから需要地点に到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、需要地点に到着するときに、車両と需要地点の間に交通レーンがない方がいい場合は、米国では 1 (車両の右側) を選択し、英国では 2 (車両の左側) を選択します。

Integer

Bearing

ポイントが移動している方向。単位は度で、北を基準に時計回りに測定されます。このフィールドは BearingTol フィールドと組み合わせて使用されます。

通常、方位データは、GPS 受信機を備えたモバイル デバイスから自動的に送信されます。歩行者や車両などの移動している入力場所を読み込んでいる場合は、方位データを含めてみてください。

このフィールドを使用すると、たとえば、車両が交差点や高架の近くにいる場合に、ロケーションが間違ったエッジに追加されるのを避けることができます。方位は、ツールがポイントを道路のどちら側に配置するかを決定する際にも役立ちます。

方位と方位許容値の詳細

Double

BearingTol

方位許容値は、Bearing フィールドを使用して移動ポイントをエッジに配置するときに、許容される方位の範囲を作成します。Bearing フィールドの値が、エッジの方位許容値から生成される許容範囲内にある場合は、ポイントをその場所にネットワーク ロケーションとして配置できます。許容範囲から外れている場合は、次に近いエッジの最も近いポイントが評価されます。

単位は度で、デフォルト値は 30 です。値は 0 より大きく 180 未満でなければなりません。値が 30 の場合、Network Analyst がネットワーク ロケーションをエッジに追加しようとすると、方位値の許容範囲がエッジの両側 (左と右) に 15 度ずつ、どちらもエッジのデジタイズされた方向に生成されます。

方位と方位許容値の詳細

Double

NavLatency

このフィールドは、BearingBearingTol の値が存在する場合にのみ、解析処理で使用されます。ただし、BearingBearingTol の値が存在する場合でも、NavLatency 値の入力は任意です。NavLatency は、移動中の車両からサーバーに GPS 情報が送信されてから、車両のナビゲーション デバイスが処理されたルートを受信するまでの予想経過時間を示します。

NavLatency の時間単位は、解析オブジェクトの timeUnits プロパティで指定された単位と同じです。

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

これらのプロパティを組み合わせて、オブジェクトが配置されているネットワーク上のポイントを表します。

Point barrier

一時的な規制として機能する 1 つ以上のポイント、または対象の道路を通行するために必要とされる追加の時間や距離を表す 1 つ以上のポイントを指定する場合に、このパラメーターを使用します。たとえば、ポイント バリアを使用して、道路沿いの倒木や、踏切で生じる遅延時間を表すことができます。

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

String

BarrierType

ポイント バリアの通過を完全に禁止するか、通過時に時間または距離を追加するかを指定します。この属性の値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (通過不可): バリアを通過できません。バリアは通過不可として機能するので、通過不可ポイント バリアとも呼ばれます。

  • 2 (追加コスト) - バリアを通過するたびに、[Additional_Time]、[Additional_Distance] フィールドまたは [Additional_Cost] フィールドで指定した値だけ、移動時間または距離が加算されます。このバリア タイプは、追加コスト ポイント バリアとも呼ばれます。

Short

Additional_Time

バリアを通過するときに追加される移動時間。このフィールドは、解析の移動モードが時間ベースのインピーダンス属性を使用する場合にのみ、追加コスト バリアにのみ適用されます。

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the timeUnits property.

Double

Additional_Distance

バリアを通過するときに追加される距離。このフィールドは、解析の移動モードが距離ベースのインピーダンス属性を使用する場合にのみ、追加コスト バリアにのみ適用されます。

This field value must be greater than or equal to zero, and the values are interpreted to be in the units specified by the distanceUnits property.

Double

Additional_Cost

バリアを通過するときに追加されるコスト。このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ、追加コスト バリアにのみ適用されます。

This field value must be greater than or equal to zero, and the values are interpreted to be in unknown units.

Double

FullEdge

解析時に、通行不可ポイント バリアをエッジ要素に適用する方法を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (False) - エッジ上をバリアまでは移動できますが、バリアを通過することはできません。これがデフォルト値です。
  • 1 (True) - バリアが配置されているエッジ全体が通行不可となります。

Short

CurbApproach

バリアによって影響を受ける移動方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (車両の両側) - エッジ上での両方向への移動がバリアの対象となります。
  • 1 (車両の右側) - バリアが移動車両の右側にある場合のみ影響を与えます。同じエッジ上で、バリアが移動車両の左側にある場合は影響を与えません。
  • 2 (車両の左側) - バリアが移動車両の左側にある場合のみ影響を与えます。同じエッジ上で、バリアが移動車両の右側にある場合は影響を与えません。

ジャンクションは特定のポイントなので、右側/左側がありません。したがって、ジャンクション上にバリアを配置した場合は、アプローチ制限にかかわらずすべての車両に影響を与えます。

CurbApproach 属性は、米国の右側通行の標準と英国の左側通行の標準の両方に対応するように設計されています。まず、施設が車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらから施設に到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、施設に到着するときに、車両と施設の間に交通レーンがない方がいい場合は、米国では 1 (車両の右側) を選択し、英国では 2 (車両の左側) を選択します。

Short

Bearing

ポイントが移動している方向。単位は度で、北を基準に時計回りに測定されます。このフィールドは BearingTol フィールドと組み合わせて使用されます。

通常、方位データは、GPS 受信機を備えたモバイル デバイスから自動的に送信されます。歩行者や車両などの移動している入力場所を読み込んでいる場合は、方位データを含めてみてください。

このフィールドを使用すると、たとえば、車両が交差点や高架の近くにいる場合に、ロケーションが間違ったエッジに追加されるのを避けることができます。方位は、ツールがポイントを道路のどちら側に配置するかを決定する際にも役立ちます。

方位と方位許容値の詳細

Double

BearingTol

方位許容値は、Bearing フィールドを使用して移動ポイントをエッジに配置するときに、許容される方位の範囲を作成します。Bearing フィールドの値が、エッジの方位許容値から生成される許容範囲内にある場合は、ポイントをその場所にネットワーク ロケーションとして配置できます。許容範囲から外れている場合は、次に近いエッジの最も近いポイントが評価されます。

単位は度で、デフォルト値は 30 です。値は 0 より大きく 180 未満でなければなりません。値が 30 の場合、Network Analyst がネットワーク ロケーションをエッジに追加しようとすると、方位値の許容範囲がエッジの両側 (左と右) に 15 度ずつ、どちらもエッジのデジタイズされた方向に生成されます。

方位と方位許容値の詳細

Double

NavLatency

このフィールドは、BearingBearingTol の値が存在する場合にのみ、解析処理で使用されます。ただし、BearingBearingTol の値が存在する場合でも、NavLatency 値の入力は任意です。NavLatency は、移動中の車両からサーバーに GPS 情報が送信されてから、車両のナビゲーション デバイスが処理されたルートを受信するまでの予想経過時間を示します。

NavLatency の時間単位は、解析オブジェクトの timeUnits プロパティで指定された単位と同じです。

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

これらのプロパティを組み合わせて、オブジェクトが配置されているネットワーク上のポイントを表します。

Line barrier

道路と交差しているラインの場所を移動できないようにする 1 つ以上のラインを指定する場合に、このパラメーターを使用します。たとえば、複数の道路区間にわたって通行禁止となるパレードやデモを表すときに通過不可ライン バリアを使用します。また、ライン バリアを使用すれば、道路網の特定の区間を迂回して利用できる経路をすばやく見つけることができます。

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

String

BarrierType

バリアの通過を完全に禁止するか、バリアを通過する際のコスト (時間または距離など) を係数に基づいて計算するかを指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (通行不可) - バリアが交通ネットワークと交差している場所の通過を禁止します。このバリアは、ライン バリアと呼ばれます。

  • 1 (コスト係数指定) - [ScaledTimeFactor] フィールドまたは [ScaledDistanceFactor] フィールドで指定した係数が、対象の道路の通過に費やすコスト (移動時間または距離など) に乗算されます。道路の一部だけがバリアの対象になっている場合は、移動の時間または距離が比率に応じて乗算されます。たとえば、係数 0.25 を割り当てると、対象の道路での移動速度が通常の 4 倍速くなります。係数 3.0 を指定すると、対象道路での移動時間が通常の 3 倍長くなります。このバリア タイプは、コスト係数ライン バリアとも呼ばれます。このバリア タイプを使用して、建設中の車線の通行止めに起因する減速をモデル化できます。

Short

ScaledTimeFactor

これは、バリアが交差している道路の移動時間に乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが時間ベースのインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

ScaledDistanceFactor

これは、バリアが交差している道路の距離に乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが距離ベースのインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

ScaledCostFactor

これは、バリアと交差する道路のコストに乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

Locations

このフィールドの情報は、ラインまたはポリゴンで覆われるネットワークのエッジ、および覆われる各エッジ エレメントの部分を定義します。このフィールドに含まれる情報を直接読んだり編集したりすることはできませんが、Network Analyst は解析を実行する際にその情報を解釈します。

Blob

Polygon barrier

通過を完全に禁止するポリゴン、またはそのポリゴンと交差する道路を移動するときに時間または距離が係数に基づいて乗算されるポリゴンを指定する場合に、このパラメーターを使用します。

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

String

BarrierType

バリアの通過を完全に禁止するか、バリアを通過する際のコスト (時間または距離など) を係数に基づいて計算するかを指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (通過不可): バリアのどの部分も通過できません。バリアと交差する道路は通過不可になるので、バリアは通過不可ポリゴン バリアとも呼ばれます。たとえば、複数の道路を含む領域が浸水し、それらの道路を通過できない状況を表す場合などに、このタイプのバリアを使用します。

  • 1 (コスト係数指定) - [ScaledTimeFactor] フィールドまたは [ScaledDistanceFactor] フィールドで指定した係数が、対象の道路の通過に費やすコスト (移動時間または距離など) に乗算されます。道路の一部だけがバリアの対象になっている場合は、移動の時間または距離が比率に応じて乗算されます。たとえば、係数 0.25 を割り当てると、対象の道路での移動速度が通常の 4 倍速くなります。係数 3.0 を指定すると、対象道路での移動時間が通常の 3 倍長くなります。このバリア タイプは、コスト係数ポリゴン バリアとも呼ばれます。暴風のため特定領域の移動速度が低下する場合などに使用できます。

Short

ScaledTimeFactor

これは、バリアが交差している道路の移動時間に乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが時間ベースのインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

ScaledDistanceFactor

これは、バリアが交差している道路の距離に乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが距離ベースのインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

ScaledCostFactor

これは、バリアと交差する道路のコストに乗算する係数です。このフィールドには 0 より大きい値を指定する必要があります。

このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ、コスト係数指定バリアにのみ適用されます。

Double

Locations

このフィールドの情報は、ラインまたはポリゴンで覆われるネットワークのエッジ、および覆われる各エッジ エレメントの部分を定義します。このフィールドに含まれる情報を直接読んだり編集したりすることはできませんが、Network Analyst は解析を実行する際にその情報を解釈します。

Blob