location/search-latest-position

最新位置検索

複数端末の最新位置を検索します。
データ保存期間をすぎると自動削除を行うため、さかのぼって検索できる期間はデータ保存期間に依存します。

その他の共通仕様は位置情報収集基盤API共通仕様をご確認ください。

https://[domain]/location/search-latest-position

HTTP request method

POST

ContentType

application/x-www-form-urlencoded

Parameters

名前 説明
request_data
*required
string		 リクエストデータ
jsonデータ。詳細は下記参照

request_dataのjsonパラメータ

名前 説明
deviceIds
array[string]		 端末ID
端末IDの配列
取得対象の端末IDを指定してください。
空の配列はエラーとなります。
最小個数 1個
最大個数 100個
各端末IDは、半角英数字とハイフン、アンダーバーのみ使用可能で、最小文字数4文字、最大文字数40文字です。
fromTime
string		 開始日時
取得対象の開始日時
yyyy-MM-ddTHH:mm:ss形式
終了日時が設定されている場合、それより大きい値が設定されているとパラメータエラーとなります。
toTime
string		 終了日時
取得対象の終了日時
yyyy-MM-ddTHH:mm:ss形式
開始日時が設定されている場合、それより小さい値が設定されているとパラメータエラーとなります。
lat
number		 緯度
検索中心位置。世界測地系緯度
DEG形式(10進表記)
経度が設定されている場合は必須です。
小数部は10桁以下にしてください。
最小値 -90
最大値 90
例:35.6894
lon
number		 経度
検索中心位置。世界測地系経度
DEG形式(10進表記)
緯度が設定されている場合は必須です。
小数部は10桁以下にしてください。
最小値 -180
最大値 180
例:139.6917
radius
number
default 1000		 検索半径(m)
緯度経度からの検索半径を距離(m)で指定してください。
緯度経度が設定されている場合にのみ有効です。
最小値 0
最大値 2,000,000
searchExtraWord
string		 付加情報検索キーワード
検索したいキーワードを設定してください。
半角英数字と記号「%,*」のみ使用可能です。部分一致の場合は*でワイルドカード検索が可能です。部分一致の場合はカンマ「,」区切りで複数単語を設定することによりOR検索が可能です。日本語を使用したい場合は、UTF-8のurlエンコードなどを行ってください。
例:テスト → %e3%83%86%e3%82%b9%e3%83%88
最大文字数 200文字
searchOption
string
default forward		 検索オプション
forward:前方一致 partial:部分一致。
前方一致の方が高速なため前方一致での検索を推奨します。
sort
string
default time		 ソート条件
time:日時ソート
distance:緯度経度からの距離。distanceの場合は緯度経度が必須です。
device:端末IDソート
order
string
default asc		 ソート順
ソート順。
asc:昇順
desc:降順
limit
integer
default 100		 取得件数
取得開始位置を基準とした取得件数。
最小値 1
最大値 1,000
offset
integer
default 1		 取得開始位置
絞込み後のデータに対する取得開始位置。
最小値 1
最大値 100,000,000,000

Responses

Media type:application/json

キー名 説明
response status returnCode
integer		 処理結果コード
0:正常
0以外:エラーコード
errorMessage
string		 エラーメッセージ
returnCodeが0以外の場合に出力
result limitAfterCount
integer		 limit後件数
limitによる絞り込み後の件数。positionsの個数と同数。
limitBeforeCount
integer		 limit前件数
limitによる絞り込み前の件数。
limitとoffsetを指定しなかった場合に取得できるデータの総件数と同数。
positions deviceId
integer		 端末ID
取得対象の端末ID。
time
integer		 位置取得日時
位置情報を取得した日時。
timezoneは日本(JST)。
(yyyy-MM-ddTHH:mm:ss形式)
lat
number		 緯度
世界測地系緯度
DEG形式(10進表記)
例:35.6894
lon
number		 経度
世界測地系緯度
DEG形式(10進表記)
例:139.6917
accuracy
number		 水平精度
水平方向の精度(m)。
bearing
number		 方位
北を0とした時計回り360度
altitude
number		 標高
標高(m)。
speed
number		 速度
速度(m/s)。
extra
string		 付加情報
検索条件として利用できる位置情報に付加された情報。
unsearchableExtra
string		 非検索付加情報
検索条件として利用できない位置情報に付加された情報。

Example

リクエストURL 
https://[domain]/location/search-latest-position

・request_data例
{
    "deviceIds": [
        "device1",
        "device2"
    ],
    "fromTime": "2019-01-24T00:00:01",
    "toTime": "2019-01-24T00:00:01",
    "lat": 35,
    "lon": 137,
    "radius": 10000,
    "searchExtraWord": "hogehoge",
    "searchOption": "forward",
    "sort": "time",
    "order": "asc",
    "limit": 100,
    "offset": 1
}
レスポンス 
{
    "response": {
        "status": {
            "returnCode": 0
        },
        "result": {
            "limitAfterCount": 2,
            "limitBeforeCount": 2,
            "positions": [
                {
                    "deviceId": "string",
                    "time": "yyyy-MM-ddTHH:mm:ss",
                    "lat": 35,
                    "lon": 137,
                    "accuracy": 10,
                    "bearing": 90,
                    "altitude": 10,
                    "speed": 5,
                    "extra": "string",
                    "unsearchableExtra": "string"
                },
                {
                    "deviceId": "string",
                    "time": "yyyy-MM-ddTHH:mm:ss",
                    "lat": 35,
                    "lon": 137,
                    "accuracy": 10,
                    "bearing": 90,
                    "altitude": 10,
                    "speed": 5,
                    "extra": "string",
                    "unsearchableExtra": "string"
                }
            ]
        }
    }
}