ARC eye VL API

概要

ARC eye Visual Localization (VL) APIは、カメラを含むビジョンデバイスから収集された情報を通じて、屋外と GPSが届かない屋内でも現在位置を正確に教えてくれる測位サービスを提供します。画像だけで屋内位置データを確認できます。

空間データの構築

コンソールで空間データを構築して、VL APIを使用することができます。SLAMデータ変換から SLAMデータマージ、ローカライズ、VLデータ変換まで、すべての作業を順に行う必要があります。詳細は、ARC eyeご利用ガイドをご参照ください。

APIの準備

VLデータマージに成功すると、ARC eye > APIメニューに「待機」状態の APIが作成されます。その APIを選択してデプロイすると、VL APIを使用できます。
他の APIを作成してデプロイするバージョンを変更する場合、既存の APIは停止されます。*停止中には他の APIをデプロイできません。

リクエスト

リクエストヘッダ

リクエストボディ

CURL example:

curl -X POST '{invokeUrl}' \
-H 'X-ARCEYE-SECRET: {secretKey}' \
-H 'Content-Type: multipart/form-data' \
-F 'image=@location.jpg;type=image/jpeg'

curl -X POST '{invokeUrl}' \
-H 'X-ARCEYE-SECRET: {secretKey}' \
-H 'Content-Type: multipart/form-data' \
-F 'image=@location.jpg;type=image/jpeg' \
-F 'odometry=0,0,0,1,0,0,0' \
-F 'lastPose=0,0,0,1,0,0,0' \
-F 'cameraParameters=1186.7,1406.5,540,960,0.0,0.0,0.0,0.0,0.0' \
-F 'withlnlier=true'

レスポンス

レスポンスボディ

レスポンス例

{
  "result": "SUCCESS",
  "status": "success",
  "pose": "VL0_0000050014880892_000000006.jpg,2.746507,9.889554,-20.729435,0.657244,-0.096816,-0.068169,0.744318",
  "total": 7738,
  "inlier": 1762,
  "inliers": [
    {
      "U" : 356.8439,
      "V" : 146.9978,
      "X" : 114.01553,
      "Y" : 233.33755,
      "Z" : 12.9115095
    }
  ],
  "residual": 5.998124,
  "floor": "ground",
  "lonlat": "126.61787915108854,37.47318807235039",
  "globalPose": "VL0_0000050014880892_000000006.jpg,37.47318807235039,126.61787915108854,21.688565,0.657244,-0.096816,-0.068169,0.744318",
  "nnPoses": [
    "VL0_1663124545528216.jpg,3.219894,17.559616,-19.898514,0.720037,-0.121523,-0.006865,0.683177",
    "VL1_1663124536528144.jpg,3.498234,18.586061,-20.282135,0.721541,-0.07256,-0.117165,0.678518",
    "VL2_1663124537528455.jpg,2.849693,18.648811,-20.386539,0.631969,-0.018601,-0.109304,0.767022",
    "VL0_1663124544528213.jpg,3.159655,16.287134,-19.874195,0.701073,-0.139553,0.015575,0.699127",
    "VL1_1663124521528042.jpg,4.446866,15.010426,-19.975168,0.755891,-0.150474,-0.035666,0.636171",
    "VL1_1663124543528186.jpg,3.704958,15.066489,-20.11025,0.761836,-0.152187,-0.059388,0.626832",
    "VL4_1663124540528089.jpg,4.224849,16.700996,-20.057743,0.601045,-0.055503,-0.034118,0.796555",
    "VL0_1663124547528227.jpg,2.683109,20.13681,-20.074528,0.543752,-0.150696,-0.013089,0.825502",
    "VL4_1663124516527975.jpg,3.005801,17.602791,-20.282951,0.761109,-0.017261,-0.000655,0.648394",
    "VL2_1663124520528189.jpg,5.639919,15.146515,-19.748491,0.675394,-0.108291,-0.088871,0.724029",
    "VL1_1663124513527983.jpg,4.592686,18.804764,-20.067684,0.770351,-0.120287,-0.11107,0.616242"
  ],
  "datasetInfo": "123_LOCAL_GND_1F_084"
}

{
  "result": "FAILURE",
  "status": "success",
  "message": "internal server error",
  "pose": "failed",
  "floor": "",
  "lonlat": "",
  "globalPose": "",
  "datasetInfo": ""
}

エラーコード

エラーレスポンス:

{
  "code": "9999",
  "message": "Unknown server error.",
  "path": "/api/v1",
  "product": "ARC eye",
  "traceId": "9c1f55ac7d8341d792a922b2590c045f",
  "timestamp": 1570776853475,
  "status": "500"
}

WiFiレスポンス

WiFiレスポンスボディ

WiFiレスポンス例

{
  "result": "SUCCESS",
  "position": "16.6337711608804,5.690108685931897",
  "lonLat": "127.105412759367,37.359465269300976",
  "datasetInfo": "Naver_1784_1F",
  "datasetInfoScore": 0.6852494
}

WiFiエラーコード

エラーレスポンス:

{
  "traceId": "3d77c10b1a0646659b6c897a35a5fa64",
  "path": "/vl/v1/300568/9bb1a2b6f8031e355dfdb8e5205a1f7a860b167a0fcbd35681235f35c3629634/location",
  "timestamp": 1725449250446,
  "product": "ARC eye",
  "status": 422,
  "code": "0100",
  "message": "Invalid parameters.",
  "details": "there are no valid signals"
}