| | GetMyLocation メソッド | |
操作で発生する可能性のあるエラーを無視する新しいフラグを考慮して、デバイスの現在の位置を取得します。次の 2 つのエラーが考慮されます:
- Location Services are disabled. 表示されるメッセージは、GXM_LocationServicesAreDisabled です。
- The app does not have permission to get the Location Services. 表示されるメッセージは、GXM_CouldNotGetLocationInformation です。
パラメーター
| 名前 |
タイプ |
説明 |
既定値 |
| minAccuracy |
Numeric(8,0) |
必要な最小精度を指定します。この精度はメートル単位で指定します。0 の場合、GPS 情報の精度は無視されます。 |
0 |
| timeout |
Numeric(8,0) |
指定された精度で位置を取得するための最長待機時間を、秒単位で指定します。デバイスが指定された時間内に必要な精度で位置を取得できない場合、取得可能な最も近い位置を返します。0 の場合、待機しません。 |
0 |
| includeHeadingAndSpeed |
Boolean |
進行方向と速度の情報を結果に含める必要があるかどうかを指定します。 |
False |
| ignoreErrors |
Boolean |
この操作の実行によってほかの操作をキャンセルするか、またはアプリケーションにエラーを無視させるかを指定します。True に設定されている場合は、エラーが発生すると空の値を返します。False に設定されている場合は、エラーが発生すると「Could not get location information」というメッセージを表示します。このメッセージは言語オプションを使用して翻訳することができます。 |
False |
たとえば、minAccuracy の値が 10 メートル、戻り値の精度が 500 メートルだとします。timeout パラメーターに指定された時間にまだ達していない場合は、より正確なデータを取得しようとします。指定された時間に達しても、必要な精度が取得されていない場合、メソッドは位置を返しません。
使用可能バージョン
GeneXus Evolution 2 Upgrade 3 以降で利用できます。
GeneXus Evolution 2 Upgrade 3 までの前のバージョンでは、位置情報を取得しようとしてエラーが発生したときのアプリケーションの動作が異なっていました。
- iOS: 位置情報の取得中にエラーが発生した場合、そのメソッドが含まれている Composite ブロックの実行が中止されます。
- Android: 異常がない Composite ブロックの実行を続行します。
GeneXus Evolution 2 Upgrade 3 以降では、既定の動作が同じになり、メソッドの ignoreErrors フラグで変更できます。
参考情報
一部の Android デバイスでは、この機能を正しく動作させるために Google サービスのロケーターを有効にする必要があります。
|
|
|
|
|