24.2 SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGON

書式

SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGON(
  start_address           IN  VARCHAR2,    
  country                 IN  VARCHAR2,
  cost                    IN  NUMBER,
  cost_unit               IN  VARCHAR2,
  vehicle_type            IN  VARCHAR2,    
  print_request_response  IN  VARCHAR2 DEFAULT 'FALSE'
) RETURN SDO_GEOMETRY;

または

SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGON(
  longitude               IN  NUMBER,
  latitude                IN  NUMBER,    
  cost                    IN  NUMBER,
  cost_unit               IN  VARCHAR2,
  vehicle_type            IN  VARCHAR2,    
  print_request_response  IN  VARCHAR2 DEFAULT 'FALSE'
) RETURN SDO_GEOMETRY;

説明

指定された距離コストの入力場所を囲むドライブ距離ポリゴンを計算し、ポリゴンのジオメトリをSDO_GEOMETRY形式で返します。

入力場所には、単一行アドレスを指定することも、経度および緯度を指定することもできます。

パラメータ

start_address

完全な開始住所(別々のフィールドに形式化されていません)。

country

ISOの2文字の国コード。サポートされているコードのリストを表示するには、ISO Online Browsing Platform (OBP)Country codesを参照してください。

longitude

開始点の経度値。

latitude

開始点の緯度値。

cost

開始点からの到達可能性の領域に使用するドライブ距離。

出力ポリゴンは、指定した距離内の開始点から到達可能な領域です。

cost_unit

コストの単位。

サポートされる値は、milekilometerKmおよびmeterです。

vehicle_type

距離の計算に考慮される車両のタイプ。

サポートされる値は、autoおよびtruckです

print_request_response

送信されたリクエストおよび受信したレスポンスを印刷するかどうかを決定します。

デフォルトでは、パラメータ値はFALSEです。

使用上のノート

ノート:

SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGONファンクションは、Oracle Autonomous Databaseでのみサポートされています。

Autonomous Databaseインスタンスでこのファンクションを使用するには、必要な権限が付与されていることを確認してください。詳細は、SDO_GCDR.ELOC_GRANT_ACCESSを参照してください。

SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGONファンクションは、次の入力パラメータのセットのいずれかを受け入れて、指定された場所を囲むドライブ距離ポリゴンを(ジオメトリとして)計算できます:

  • 形式化されていない住所の使用: 完全な住所が単一のフィールドに格納されている(つまり、形式化されていない)場合、start_addressパラメータを指定します。
  • 地理座標の使用: longitudeおよびlatitudeパラメータを指定して場所を決定します。

各パラメータ入力には、表またはビューの列、または明示的な文字列または数値も指定できます。

次の例では、トラックの経度と緯度を使用して指定された場所を囲むドライブ距離ポリゴンを計算します:

SELECT SDO_GCDR.ELOC_DRIVE_DISTANCE_POLYGON(-71.47374, 42.75505, 500, ‘meter', 'truck') polygon FROM DUAL;

POLYGON(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES)
------------------------------------------------------------------------------------------
SDO_GEOMETRY(2003, 4326, NULL, SDO_ELEM_INFO_ARRAY(1, 1003, 1), SDO_ORDINATE_ARRAY(-71.47863,42.75343
-71.47793,42.75366 -71.47776,42.75372 -71.47763,42.75376 -71.47515,42.75458 -71.47316,42.75412 -71.47298,
42.75301 -71.47144,42.75279 -71.47056,42.75388 -71.47142,42.75415 -71.47282,42.75423 -71.47348,
42.75578 -71.47313,42.75671 -71.4738,42.75625 -71.47423,42.75609 -71.47478,42.75597 -71.47627,
42.75619 -71.4773,42.75562 -71.47819,42.75549 -71.47863,42.75343))