REST API for Big Data Spatial and Graph

このサービスは、データ・セット内の空間クラスタを見つけるために使用します

post

/spatialviewer/api/v1/clusteringJob

このサービスでは、K-meansアルゴリズムの分散バージョンを使用します。

リクエスト

サポートされるメディア・タイプ

application/json

問合せパラメータ

非同期

型: boolean

trueの場合、この操作は非同期で実行されます。

デフォルト値

false

本文パラメータ

ジョブ詳細

ルート・スキーマ: ClusteringJobInfo

型: object

プロパティ

dataPath: 型: string

HDFS内のファイルのパス。

例: /user/oracle/spatialviewer/tweetsJune.json
inputFormatClass: 型: string

入力形式クラス。

例: oracle.spatial.hadoop.vector.geojson.mapred.GeoJsonInputFormat
jarWithNeededClasses: 型: string

カスタムRecordInfoProviderまたはInputFormatのようなユーザー定義クラスを持つJAR名。InputFormatクラスまたはRecordInfoProviderクラスがAPI、またはHadoop APIクラスにない場合、ユーザー定義クラスのJARが提供されます。このjarを使用するには、/opt/oracle/oracle-spatial-graph/spatial/web-server/spatialviewer/WEB-INF/libディレクトリに追加し、サーバーを再起動する必要があります。オプションのプロパティ。

例: myjar.jar
numberOfClusters: 型: integer (int32)

検出されるクラスタの数。

例: 4
outputPath: 型: string

Hadoopジョブの出力パス。

例: /user/oracle/spatialviewer/clusteringResult
recordInfoProviderClass: 型: string

空間情報を提供するクラス。

例: oracle.spatial.hadoop.vector.geojson.GeoJsonRecordInfoProvider
resultName: 型: string

結果名。

例: Clustering Tweets June
srid: 型: integer (int32)

ジオメトリのSRID。

例: 8307
tolerance: 型: number (double)

空間操作を実行するときに使用される許容差を表すdouble値。

例: 0.05

レスポンス

サポートされるメディア・タイプ

application/json

200レスポンス

要求が成功しました。

レスポンスには、HDFS内の結果の場所が含まれています。

ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダclustering_resultsに保存されます。結果は、表示用にMap API VectorLayer (OM.layer.VectorLayer)のデータ・ソースとして使用できます。

本文

ルート・スキーマ: ClusteringJobResponse

型: object

プロパティ

o:successCode: 型: string

成功コード。

例: SV-05005
レスポンス: 型: string

レスポンスには、HDFS内の結果の場所が含まれています。

例: hdfs://<namenode>:8020/user/oracle/spatialviewer/clusteringResult
ステータス: 型: string

成功またはエラー

例: success
タイトル: 型: string

サービスのタイトル。

例: Create clustering job.

202レスポンス

非同期リクエストを受け入れました。

レスポンスには、ジョブを追跡するためのリソース・マネージャWebアプリケーションのURLが含まれています。

さらに、ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダclustering_resultsに保存されます。結果は、表示用にMap API VectorLayer (OM.layer.VectorLayer)のデータ・ソースとして使用できます。

本文

ルート・スキーマ: AsyncClusteringJobResponse

型: object

プロパティ

o:successCode: 型: string

成功コード。

例: SV-05005
レスポンス: 型: string

レスポンスには、ジョブを追跡するためのリソース・マネージャWebアプリケーションのURLが含まれています。SpatialViewer Hadoop構成でこの値を参照してください(ユーザーズ・ガイドの第1.8.4章「Oracle Big Data ApplianceでOracle SpatialViewerの構成」を参照してください)。パラメータはyarn.resourcemanager.webapp.addressです。

例: http://resource.mananger.webapp:8088
ステータス: 型: string

成功またはエラー

例: success
タイトル: 型: string

サービスのタイトル。

例: Create clustering job.