24.10 SDO_GCDR.ELOC_ROUTE_GEOM
書式
SDO_GCDR.ELOC_ROUTE_GEOM(
route_preference IN VARCHAR2,
start_address IN VARCHAR2,
end_address IN VARCHAR2,
country IN VARCHAR2,
vehicle_type IN VARCHAR2,
print_request_response IN VARCHAR2 DEFAULT 'FALSE'
) RETURN SDO_GEOMETRY;または
SDO_GCDR.ELOC_ROUTE_GEOM(
route_preference IN VARCHAR2,
start_longitude IN NUMBER,
start_latitude IN NUMBER,
end_longitude IN NUMBER,
end_latitude IN NUMBER,
vehicle_type IN VARCHAR2,
print_request_response IN VARCHAR2 DEFAULT 'FALSE'
) RETURN SDO_GEOMETRY;説明
2つの場所の間のルートを計算し、ルートのジオメトリをSDO_GEOMETRY形式で返します。
入力場所は、単一行アドレスにすることも、地理座標で指定することもできます。
パラメータ
- route_preference
-
ルーティング・プリファレンス。
サポートされる値は、
shortest、fastestおよびtrafficです。 - start_address
-
完全な開始住所(別々のフィールドに形式化されていません)。
- end_address
-
完全な終了住所(別々のフィールドに形式化されていません)。
- country
-
ISOの2文字の国コード。サポートされているコードのリストを表示するには、ISO Online Browsing Platform (OBP)のCountry codesを参照してください。
- start_longitude
-
開始点の経度値。
- start_latitude
-
開始点の緯度値。
- end_longitude
-
終了点の経度値。
- end_latitude
-
終了点の緯度値。
- vehicle_type
-
距離の計算に考慮される車両のタイプ。
サポートされる値は、
autoおよびtruckです - print_request_response
-
送信されたリクエストおよび受信したレスポンスを印刷するかどうかを決定します。
デフォルトでは、パラメータ値は
FALSEです。
使用上のノート
ノート:
SDO_GCDR.ELOC_ROUTE_GEOMファンクションは、Oracle Autonomous Databaseでのみサポートされています。Autonomous Databaseインスタンスでこのファンクションを使用するには、必要な権限が付与されていることを確認してください。詳細は、SDO_GCDR.ELOC_GRANT_ACCESSを参照してください。
SDO_GCDR.ELOC_ROUTE_GEOMファンクションは、次のパラメータ・セットのいずれかを受け入れて、2つのポイント間のルート・ジオメトリを決定できます:
- 形式化されていない住所の使用: 完全な住所が単一のフィールドに格納されている(つまり、形式化されていない)場合、
start_addressおよびend_addressパラメータを指定します。 - 地理座標の使用:
start_longitude、start_latitude、end_longitudeおよびend_latitudeパラメータを指定して、出発地と目的地を決定します。
各パラメータ入力には、表またはビューの列、または明示的な文字列または数値を指定できます。
例
次の例では、2つの地理座標間のトラックで取得した最短ルート・ジオメトリを計算します。
SELECT SDO_GCDR.ELOC_ROUTE_GEOM('shortest', -71.46439, 42.75875,-71.46278, 42.7553, 'truck') route_geom FROM DUAL;
ROUTE_GEOM
–-------------------------------------------------------------------------------------------------------------------------------
MDSYS.SDO_GEOMETRY(2002, 4326, NULL, MDSYS.SDO_ELEM_INFO_ARRAY(1, 2, 1), MDSYS.SDO_ORDINATE_ARRAY(-71.4643900005, 42.7587499999,
-71.46439, 42.75875, -71.46433, 42.75862, -71.46431, 42.75858, -71.46421, 42.75837, -71.4641, 42.75813, -71.46397, 42.75785,
-71.46375, 42.75739, -71.4637, 42.75728, -71.46368, 42.75724, -71.46359, 42.75706, -71.46351, 42.75689, -71.46333, 42.75656,
-71.46326, 42.75639, -71.46312, 42.75605, -71.46296, 42.75568, -71.46278, 42.7553, -71.46278, 42.7553))親トピック: SDO_GCDRパッケージ(ジオコーディング)