ClosestFacility input data types

The input data types that can be specified when performing a closest facility analysis are described below.

Incidents

最寄り施設の検出解析の始点または終点として使用される場所。

The data type supports the following fields:

FieldDescriptionData type

Name

インシデントの名前。この名前は、ルート案内に使用されます。名前を指定しない場合は、出力ルートおよび出力ルート案内において接頭辞 Location が付いた一意な名前が自動的に生成されます。

Text

ID

A user-defined unique identifier for the incident. The identifier is included in the output routes (as the IncidentID field) and can help join additional information from the output routes, such as the total travel time or total distance, to attributes from your incidents or vice versa.

Text

AdditionalTime

インシデントで費やされる時間の長さ。これは、ルートの合計時間に追加されます。デフォルト値は 0 です。

The units for this attribute value are specified by the timeUnits property of the analysis object.

If you are finding the closest fire stations to fire incidents to estimate response times, for example, the AdditionalTime attribute can store the amount of time it takes firefighters to hook up their equipment at the location of the incident before they can begin fighting the fire.

Double

AdditionalDistance

インシデントで移動する追加の距離。これは、ルートの合計距離に追加されます。デフォルト値は 0 です。

The units for this attribute value are specified by the distanceUnits property of the analysis object.

Generally, the location of an incident, such as a home, isn't exactly on the street; it is set back somewhat from the road. This attribute value can be used to model the distance between the incident location and its street location if it is important to include that distance in the total travel distance.

Double

AdditionalCost

インシデントにかかる追加のコスト。これは、ルートの合計コストに加算されます。デフォルト値は 0 です。

この属性値は、解析の移動モードで時間ベースでも距離ベースでもないインピーダンス属性を使用する場合に使用する必要があります。属性値の単位は、未知の単位として解釈されます。

Double

TargetFacilityCount

指定されたインシデントに対して検索する必要のある施設の数。このフィールドでは、各インシデントに対して検出する施設数を指定できます。たとえば、このフィールドを使用して、1 つのインシデントの最寄り施設を 3 件と、別のインシデントの最寄り施設を 2 件検出できます。

A value for this field overrides the default set for the analysis using the defaultTargetFacilityCount property.

The default value is Null, which results in using the default value set by the defaultTargetFacilityCount property for all the incidents.

Long

Cutoff

指定されたインシデントからの施設の検索を中止するインピーダンス値。この属性では、各インシデントに対して異なるカットオフ値を指定できます。たとえば、この属性を使用して、1 つのインシデントから移動時間 5 分以内の施設と、別のインシデントから移動時間 8 分以内の施設を検索できます。

This attribute is used only when the travelDirection property is set to TravelDirection.ToFacility.

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 incidents.

Double

CurbApproach

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

  • 0 (車両の両側) - 車両は両方の方向でインシデントに到着する、およびインシデントから出発することができるため、インシデントでの U ターンが許可されます。この設定は、車両がインシデントで方向転換することが可能かつ現実的である場合に選択できます。これは、道路の幅と交通量に基づいて決定されたり、インシデントに車両が進入して方向転換できる駐車場があるかどうかに応じて決定されたりします。

  • 1 (車両の右側) - 車両がインシデントに到着するとき、およびインシデントから出発するときに、縁石が車両の右側にある必要があります。U ターンは許可されません。これは、通常、バス停が右側にある状態で到着する必要があるバスなどの車両に使用されます。

  • 2 (車両の左側) - 車両がインシデントに到着するとき、およびインシデントから出発するときに、縁石が車両の左側にある必要があります。U ターンは許可されません。これは、通常、バス停が左側にある状態で到着する必要があるバスなどの車両に使用されます。

  • 3 (U ターンなし) - 車両がインシデントに到着するときはどちらの側でも到着できますが、方向転換せずに出発する必要があります。

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

Long

Bearing

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

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

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

方位と方位許容値の詳細

Double

BearingTol

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

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

方位と方位許容値の詳細

Double

NavLatency

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

NavLatency の単位は、インピーダンス属性の単位と同じです。

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

ネットワーク上での入力の特定の詳細

Facilities

最寄り施設の検出解析の始点または終点として使用される場所。

The data type supports the following fields:

FieldDescriptionData type

Name

施設の名前。この名前は、ルート案内に使用されます。名前を指定しない場合は、出力ルートおよび出力ルート案内において接頭辞 Location が付いた一意な名前が自動的に生成されます。

Text

ID

A unique identifier for the facility. The identifier is included in the output routes and the output facilities as the FacilityID field. The FacilityID field can be used to join additional information from the output routes, such as the total travel time or total distance, to attributes from your facilities.

Text

AdditionalTime

施設で費やされる時間の長さ。これは、ルートの合計時間に追加されます。デフォルト値は 0 です。

The units for this attribute value are specified by the timeUnits property of the analysis object.

If you are finding the closest fire stations to fire incidents, for example, AdditionalTime can store the time it takes a crew to don the appropriate protective equipment and exit the fire station.

Double

AdditionalDistance

施設で移動する追加の距離。これは、ルートの合計距離に追加されます。デフォルト値は 0 です。

The units for this attribute value are specified by the distanceUnits property of the analysis object.

Generally, the location of a facility, such as a fire station, isn't exactly on the street; it is set back somewhat from the road. AdditionalDistance can model the distance between the facility location and its street location if it is important to include that distance in the total travel distance.

Double

AdditionalCost

施設で費やされる追加のコスト。これは、ルートの合計コストに加算されます。デフォルト値は 0 です。

この属性値は、解析の移動モードで時間ベースでも距離ベースでもないインピーダンス属性を使用する場合に使用する必要があります。属性値の単位は、未知の単位として解釈されます。

Double

Cutoff

指定された施設からのインシデントの検索を中止するインピーダンス値。この属性では、各施設に対して異なるカットオフ値を指定できます。たとえば、この属性を使用して、1 つの施設から移動時間 5 分以内のインシデントと、別の施設から移動時間 8 分以内のインシデントを検索できます。

This attribute is used only when the travelDirection property is set to TravelDirection.FromFacility.

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

If the travel mode in 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 in 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 in 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 incidents.

Double

CurbApproach

車両が施設に到着する方向および施設から出発する方向を指定します。

  • 0 (車両の両側) - 車両は両方の方向で施設に到着する、および施設から出発することができるため、施設での U ターンが許可されます。この設定は、車両が施設で方向転換することが可能かつ現実的である場合に選択できます。これは、道路の幅と交通量に基づいて決定されたり、施設に車両が進入して方向転換できる駐車場があるかどうかに応じて決定されたりします。
  • 1 (車両の右側) - 車両が施設に到着するとき、および施設から出発するときに、施設が車両の右側にある必要があります。U ターンは許可されません。これは、通常、バス停が右側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 2 (車両の左側) - 車両が施設に到着するとき、および施設から出発するときに、縁石が車両の左側にある必要があります。U ターンは許可されません。これは、通常、バス停が左側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 3 (U ターンなし) - 車両が施設に到着するときはどちらの側でも到着できますが、方向転換せずに出発する必要があります。

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

Long

Bearing

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

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

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

方位と方位許容値の詳細

Double

BearingTol

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

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

方位と方位許容値の詳細

Double

NavLatency

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

NavLatency の単位は、インピーダンス属性の単位と同じです。

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

ネットワーク上での入力の特定の詳細

PointBarriers

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

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

Text

BarrierType

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

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

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

Long

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

AdditionalCost

バリアを通過するときに追加されるコスト。 このフィールドは、追加コスト バリアにのみ適用され、[計測単位] パラメーターが時間ベースでも距離ベースでもない場合に限られます。

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) - バリアが配置されているエッジ全体が通行不可となります。

Long

CurbApproach

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

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

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

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

Long

Bearing

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

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

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

方位と方位許容値の詳細

Double

BearingTol

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

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

方位と方位許容値の詳細

Double

NavLatency

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

NavLatency の単位は、インピーダンス属性の単位と同じです。

The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.

Double

Network location fields

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

ネットワーク上での入力の特定の詳細

LineBarriers

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

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

Text

BarrierType

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

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

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

Long

ScaledTimeFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが時間ベースである場合に限られます。

Double

ScaledDistanceFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが距離ベースである場合に限られます。

Double

ScaledCostFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが時間ベースでも距離ベースでもない場合に限られます。

Double

Locations

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

ネットワーク上での入力の特定の詳細

Blob

PolygonBarriers

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

The data type supports the following fields:

FieldDescriptionData type

Name

バリアの名前。

Text

BarrierType

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

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

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

Long

ScaledTimeFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが時間ベースである場合に限られます。

Double

ScaledDistanceFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが距離ベースである場合に限られます。

Double

ScaledCostFactor

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

このフィールドは、コスト係数指定バリアにのみ適用され、[計測単位] パラメーターが時間ベースでも距離ベースでもない場合に限られます。

Double

Locations

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

ネットワーク上での入力の特定の詳細

Blob