GetTravelBoundary HTTP POST オプション
HTTP POST URL 形式
標準の HTTP GET パラメータのほか、道路タイプの周辺移動速度の変更を指定する HTTP POST ペイロード オプションを要求に追加できます。コンテンツ タイプは application/json に設定する必要があります。HTTP POST リクエストには次の形式を使用します。
HTTP POST: /rest/Spatial/erm/databases/dbsource.json?q=travelBoundary&query_parameters
POST BODY: Content-Type:application/json {Route Data}
Route Data は、道路タイプの周辺移動速度を含む計算で使用される追加のルート情報を表す POST Json 本体 (Content-Type:
application/json) です。周辺移動速度
この優先設定セットを使用して、要求ごとに周辺移動速度の変更を設定できます。周辺移動速度とは、経路境界を検索するときに道路以外を移動するために使用する、標準データにおける速度の変更です。道路以外とは、私道や進入路などのことです。次は、周辺移動速度パラメータの説明です。
パラメータ |
説明 |
---|---|
DefaultAmbientSpeed |
(すべての道路タイプの) 到達圏境界を検索するために使用する、道路以外を移動する際の速度を指定します。到達圏境界計算において道路外の移動の処理を制御するには、道路外を移動する際の速度 (周辺移動速度) を指定する必要があります。周辺移動速度は、到達圏境界を表すポリゴンの大きさや形状に影響を与える可能性があります。一般的には、周辺移動速度が速いほど、ポリゴンは大きくなります。例えば、あと 5 分の移動が可能で、周辺移動速度が 15 マイル/時の場合は、到達可能地点まで 1.25 マイルの距離があることになります。周辺移動速度を 10 マイル/時に落とすと、到達可能地点までの距離は 0.83 マイルになります。
注: DefaultAmbientSpeed のデフォルト値: 15 |
AmbientSpeedUnit |
周辺移動速度を計算するための計測単位を指定します。使用可能な速度単位は以下のとおりです。
注: AmbientSpeedUnit のデフォルト値: MPH |
AmbientSpeed.RoadType |
道路の種類ごとに、道路外を移動する際の周辺移動速度を指定します。道路タイプとその道路タイプの新しい速度を指定する必要があります。速度は、定義済みの AmbientSpeedUnit に定義されます。道路タイプは、サポートされているすべてのタイプで返すことができます。次の道路タイプを使用できます。
|
伝搬係数 | 伝搬係数 の詳細については、クエリ パラメータを参照してください。 注: このパラメータは、getTravelBoundary バージョン 2 が指定されている場合にのみサポートされます。 |
道路タイプ | 道路タイプに基づいて、道路外を移動する際に使用する 伝搬係数 を指定します。道路タイプと、その道路タイプに対する伝搬係数の新しい値の両方を指定する必要があります。詳細については、「伝搬係数」を参照してください。道路タイプは、サポートされているすべてのタイプで返すことができます。次の道路タイプを使用できます。
注: このパラメータは、getTravelBoundary バージョン 2 が指定されている場合にのみサポートされます。 |
除外 | 到達圏境界計算中に回避する道路タイプのリストをカンマで区切って指定します。これは文字列パラメータです。パラメータの値として道路タイプを指定すると、計算で境界からそのタイプの道路が除外されます。例えば、パラメータの値として有料道路を指定すると、計算された境界から有料道路が除外されます。 |
gettravelboundary バージョン 1 の HTTP POST ペイロードでの周辺移動速度パラメータの使用例。
{
"DefaultAmbientSpeed": 45,
"AmbientSpeedUnit": "MPH"
"AmbientSpeed.RoadType.PrimaryHighwayUrban": 15,
"AmbientSpeed.RoadType.SecondaryHighwayUrban": 10
}
gettravelboundary バージョン 2 の HTTP POST ペイロードでの周辺移動速度パラメータおよび 伝搬係数 パラメータの使用例。
{
"ambientSpeeds": {
"defaultAmbientSpeed": 24,
"ambientSpeedUnit": "MPH",
"ambientSpeedOverrides": {
"Primary Highway Urban": ".51",
"Secondary Highway Urban": ".1"
}
},
"propagationFactors": {
"propagationFactor": "1",
"propagationFactorOverrides": {
"Primary Highway Urban": ".51",
"Secondary Highway Urban": ".1"
}
}
}
{
"ambientSpeeds": {
"ambientSpeedOverrides": {
"Primary Highway Urban": 25,
"Secondary Highway Urban": 10
}
},
"propagationFactors": {
"propagationFactor": "0.2",
"propagationFactorOverrides": {
"Primary Highway Urban": "0.51",
"Secondary Highway Urban": "0.1"
}
}
}
注: REST 要求からの応答は JSON 形式で、返されるジオメトリは GEOJSON 形式です。