そのほかの機能: 基地局 / デバイスの位置情報を取得する | SORACOM Air for セルラー

基地局の位置情報とデバイスの位置情報を取得できます。

位置情報の種類	対応サブスクリプション	料金	位置情報の取得方法
基地局の位置情報	すべて	無料	SORACOM ユーザーコンソールで確認したり、SORACOM CLI / SORACOM API で取得したりできます。
デバイスの簡易的な位置情報 (簡易位置測位機能)	plan-KM1	有料 (*1)	Unified Endpoint に送信したデータが、SORACOM Beam / Funnel / Funk / Harvest Data に送信される際に、デバイスの簡易的な位置情報もあわせて送信されます。

(*1) 詳しくは、ご利用料金 – 特定地域向け IoT SIM の簡易位置測位機能を参照してください。

基地局の位置情報を取得する

IoT SIM を利用するデバイスが接続する 基地局の位置情報 を、SORACOM から取得します。基地局の位置情報を取得できる条件は以下のとおりです。

SORACOM IoT SIM を利用している場合は、カード型 / チップ型 SIM、2G / 3G / 4G のいずれかのセッション履歴が存在する。
特定地域向け IoT SIM を利用している場合は、4G / 5G のいずれかのセッション履歴が存在する。
セッション履歴として取得できる基地局に関する情報 (mcc、mnc、tac、eci) に対応する位置情報が Mozilla Location Service に登録されている。

基地局の位置情報取得の制限事項

この機能で取得できる位置情報は、基地局の位置情報です。IoT SIM を利用するデバイスの位置情報ではありません。
位置情報のもととなる基地局に関する情報はセッションが確立した時点のものです。そのため、セッションを切断して再接続をしない限り基地局の情報は更新されません。
特定地域向け IoT SIM を利用している場合は、2G / 3G のセッション履歴が存在しても基地局に関する情報は取得できません。また、基地局に関する情報は、サブスクリプションや利用回線、そのほかの状況によって確認できない場合があります。
デバイスが接続する基地局の位置情報が、Mozilla Location Service に登録されていない場合は、位置情報を取得できません。たとえば都市部以外の地域 (特に山間部や海上など) では、位置情報が登録されていない基地局が多いため、位置情報を取得できない場合があります。
複数のデバイスが近くに設置されていても、同一の基地局と通信しているとは限りません。その結果、一部のデバイスのみ位置情報を取得できない場合や、デバイスによって異なる位置を示す場合があります。

IoT SIM を利用するデバイスが接続する 基地局の位置情報 は、デバイスから取得することもできます。詳しくは、SIM ローカル情報レポートを取得するを参照してください。

ユーザーコンソールにログインし、基地局の位置情報を取得する IoT SIM にあわせてカバレッジタイプを変更します。
たとえば、plan01s の IoT SIM に基地局の位置情報を取得する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更するを参照してください。
[メニュー] → [SORACOM AIR FOR セルラー] → [SIM 管理] の順にクリックします。
SIM 管理画面が表示されます。
IoT SIM の一覧に、基地局の位置情報を SORACOM から取得できている IoT SIM が含まれる場合は、一覧の下に地図が表示され、IoT SIM が現在利用する基地局の位置情報が表示されます。
- 簡易位置測位機能で取得した位置情報は、SIM 管理画面には表示できません。
- 基地局の位置情報が取得できない場合は、地図も表示されません。
- 複数の IoT SIM の基地局の位置情報が取得できていた場合は、基地局の位置情報を表示する IoT SIM にチェックを入れると、その IoT SIM の基地局の位置情報だけが表示されます。
- オフラインの IoT SIM が最後に利用していた基地局の位置情報は、SIM 管理画面では表示されません。最後に利用していた基地局の位置情報を確認するには、SIM 詳細画面の [セッション詳細] を確認します。詳しくは、セッション履歴を確認するを参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、基地局の位置情報を取得できます。

SORACOM CLI
SORACOM API

SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールするを参照してください。
SIM ID は、soracom sims list (Sim:listSims API) で取得できます。

4G 回線の例:

soracom sims get (Sim:getSim API) を使用して、セッション情報から mcc、mnc、tac、eci を取得します。
```
$ soracom sims get --sim-id ${sim_id} | jq .sessionStatus.cell
{
  "eci": 12345678,
  "mcc": 440,
  "mnc": 10,
  "radioType": "lte",
  "tac": 1234
}
```
オフラインの IoT SIM の場合は、sessionStatus (現在のセッション情報) を previousSession (前回のセッション情報) に置き換えてください。

soracom cell-locations get (CellLocation:getCellLocation API) を使用します。

$ soracom cell-locations get --mcc 440 --mnc 10 --tac 1234 --eci 12345678

SORACOM API を利用するには、API キーと API トークンが必要です。詳しくは、API キーと API トークンの取り扱いについてを参照してください。
SIM ID は、Sim:listSims API で取得できます。

4G 回線の例:

Sim:getSim API を使用して、mcc、mnc、tac、eci を取得します。

$ curl -v -X GET "https://api.soracom.io/v1/sims/${sim_id}" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}" | jq .sessionStatus.cell
{
  "eci": 12345678,
  "mcc": 440,
  "mnc": 10,
  "radioType": "lte",
  "tac": 1234
}

オフラインの IoT SIM の場合は、sessionStatus を previousSession に置き換えてください。

CellLocation:getCellLocation API を使用します。

$ curl -v -X GET "https://api.soracom.io/v1/cell_locations?mcc=440&mnc=10&tac=1234&eci=12345678" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}"

デバイスの簡易的な位置情報 (簡易位置測位機能) を送信する (plan-KM1 のみ)

簡易位置測位機能は、Unified Endpoint を利用して任意のデータを送信したときに、4G 通信のセッション確立時のデバイスの簡易的な位置情報を、SORACOM Beam / Funnel / Funk / Harvest Data に送信する機能です。

簡易位置測位機能の制限事項

簡易位置測位機能を利用するには、plan-KM1 の IoT SIM が必要です。なお、GPS モジュールや Wi-Fi モジュールは不要です。
4G 通信のセッション確立時の位置情報を送信するため、セッションを確立し直すまでは位置情報は更新されません。送信するたびに位置情報を更新するには、送信するたびにセッションを確立し直してください。
Unified Endpoint を利用してください。SORACOM Beam / Funnel / Funk / Harvest Data のエントリポイントにデータを送信しても、位置情報は送信されません。

SORACOM LTE-M Button for Enterprise (以下、Enterprise ボタン) は、plan-KM1 の IoT SIM を使用しているため、簡易位置測位機能が利用できます。Enterprise ボタンで簡易位置測位機能を有効化する操作については、簡易位置測位機能を参照してください。

ステップ 1: SIM グループの作成および初期設定

簡易位置測位機能を利用するために、以下の初期設定を行います。

簡易位置測位機能および SORACOM Harvest Data の設定はグループに対して行います

ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作について詳しくは、グループ設定を参照してください。

SIM グループ画面で [SORACOM Air for セルラー設定] をクリックします。
SIM グループ画面を表示する操作について詳しくは、グループの設定を変更するを参照してください。
[簡易位置測位機能] をクリックして「ON」にし、[保存] をクリックします。
SORACOM Harvest Data (以下、Harvest Data) で位置情報を可視化する場合は、plan-KM1 の IoT SIM が所属するグループで Harvest Data を有効化します。詳しくは、Harvest Data を有効化するを参照してください。
IoT SIM が所属するグループを切り替えます。
グループに所属する IoT SIM の簡易位置測位機能と Harvest Data が有効化されます。

plan-KM1 以外のサブスクリプションを契約している IoT SIM では簡易位置測位機能は利用できません

簡易位置測位機能を利用できるサブスクリプションは plan-KM1 のみです。plan-D など、plan-KM1 以外のサブスクリプションを契約している IoT SIM では、簡易位置測位機能を有効化したグループに所属させても、位置情報は送信されません。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、簡易位置測位機能の設定を変更できます。

SORACOM CLI
SORACOM API

SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールするを参照してください。
${group_id} は、soracom groups list (Group:listGroups API) で取得できます。
${namespace} は、SoracomAir です。
ボディで指定するプロパティについては、ボディで指定するプロパティについてを参照してください。
ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作について詳しくは、グループ設定を参照してください。

簡易位置測位機能を設定する

soracom groups put-config (Group:putConfigurationParameters API) を使用します。

$ soracom groups put-config --group-id ${group_id} --namespace SoracomAir \
--body '[
  {
    "key": "locationEnabled",
    "value": true
  }
]'

SORACOM API を利用するには、API キーと API トークンが必要です。詳しくは、API キーと API トークンの取り扱いについてを参照してください。
${group_id} は、Group:listGroups API で取得できます。
${namespace} は、SoracomAir です。
ボディで指定するプロパティについては、ボディで指定するプロパティについてを参照してください。
ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作について詳しくは、グループ設定を参照してください。

簡易位置測位機能を設定する

Group:putConfigurationParameters API を使用します。

$ curl -v -X PUT https://api.soracom.io/v1/groups/${group_id}/configuration/SoracomAir \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '[
  {
    "key": "locationEnabled",
    "value": true
  }
]'

ボディで指定するプロパティについて

以下の key と value のペアを配列で指定します。

key value の型 value

`key`	`value` の型	`value`
`locationEnabled`	Boolean	簡易位置測位機能の ON/OFF を設定します。 `true`: ON `false`: OFF

locationEnabled

Boolean

簡易位置測位機能の ON/OFF を設定します。

true: ON
false: OFF

想定していない値を指定した場合の動作は、定義されていません。SORACOM CLI / SORACOM API で設定を変更したあとで、SORACOM ユーザーコンソールで意図通りに設定されていることを確認してください。

ステップ 2: セッションを確立してデータを送信する

plan-KM1 の IoT SIM を利用するデバイスで、セッションを確立して Unified Endpoint に任意のデータを送信します。

セッション確立時点のデバイスの位置情報が、Unified Endpoint に送信した任意のデータとともに SORACOM Beam / Funnel / Funk / Harvest Data に送信されます。

ステップ 3: Harvest Data で簡易的な位置情報を可視化する

Harvest Data を有効化した場合は、Harvest Data で位置情報を確認できます。詳しくは、Harvest Data に保存したデータを確認するを参照してください。

locationservice

SORACOM Beam / Funnel / Funk / Harvest Data に送信された位置情報のデータフォーマットについては、簡易位置測位機能のデータフォーマットを参照してください。

基地局の位置情報取得の制限事項

簡易位置測位機能の制限事項

簡易位置測位機能 および SORACOM Harvest Data の設定はグループに対して行います

plan-KM1 以外のサブスクリプションを契約している IoT SIM では簡易位置測位機能は利用できません

簡易位置測位機能および SORACOM Harvest Data の設定はグループに対して行います