SFBPosDet

IPosDet インターフェースのラッパークラスです。

#include <SFBPosDet.h.hpp>

class SFBPosDet : public SFBQuery;

SFMTYPEDEFWRAPPER(SFBPosDet)

継承図

バージョン

BREW 2.0	BREW 2.1	BREW 3.1	BREW 4.0
○	○	○	○

参照

BREW API IPosDet

メンバ

パブリック関数
`SFCError`	ExtractPositionInfo( `AEEGPSInfo` gps , `AEEPositionInfoEx` position ) AEEGPSInfo で指定された位置について、AEEPositionInfoEx で指定される形式で位置情報を生成します。
`SFCError`	GetGPSConfig( `AEEGPSConfig*` config ) GPS エンジンの現在の GPS 構成を取得します。
`SFCError`	GetGPSInfo( `AEEGPSReq` request , `AEEGPSAccuracy` accuracy , `AEEGPSInfo*` info , `SFXCallbackPtr` callback ) GPS に基づく位置情報を取得します。
`SFCError`	GetOrientation( `AEEOrientationReq` orientation , `VoidPtr` info , `SFXCallbackPtr` callback ) 水平面上のデバイスの方角を取得します。
`SFCError`	GetOrientation( `AEEOrientationReq` orientation , `SFXBufferPtr` info , `SFXCallbackPtr` callback ) 水平面上のデバイスの方角を取得します。
`SFCError`	GetSectorInfo( `AEESectorInfo*` info ) セクターに基づくポジションロケーション情報、たとえば、システム ID、ネットワーク ID、基地局 ID、基地局クラス、ベストパイロットなどを取得します。
static `SFBPosDetSmp`	NewInstance( `SFCErrorPtr` exception = null ) SFBPosDet インスタンスを生成します。
static `SFBPosDetSmp`	NewInstance( `AEECLSID` id , `SFCErrorPtr` exception = null ) SFBPosDet インスタンスを生成します。
`SFCError`	SetGPSConfig( `AEEGPSConfig*` config ) GPS エンジンが使う GPS 構成を設定します。
static `Float64`	WGS84ToDegrees( `SInt32` latlon ) WGS84 回転楕円形式の緯度または経度を 10 進度形式に変換します。
`SFCError`	QueryInterface( `AEECLSID` clsid , `VoidHandle` handle ) (SFBQuery から継承) このオブジェクトからの別の API を問い合わせます。
`SFCError`	QueryInterface( `AEECLSID` clsid , `SFBBaseSmpPtr` handle ) (SFBQuery から継承) このオブジェクトからの別の API を問い合わせます。
`SFBBaseSmp`	QueryInterface( `AEECLSID` clsid ) (SFBQuery から継承) このオブジェクトからの別の API を問い合わせます。
`Void`	Self( `AEECLSID` clsidReq , `SFBQuerySmpPtr` clone , `AEECLSID` clsidImp ) (SFBQuery から継承) オブジェクトを単一インターフェースで実装するときに使います。
`SFBQuerySmp`	Self( `AEECLSID` clsidReq , `AEECLSID` clsidImp ) (SFBQuery から継承) オブジェクトを単一インターフェースで実装するときに使います。

プロテクト関数
static `SFBBaseSmp`	FactoryByCreate( `AEECLSID` id , `SFCErrorPtr` exception = null ) (SFBBase から継承) 指定したクラス ID のインターフェースのインスタンスを生成します。
static `SFBBaseSmp`	FactoryByQuery( `SFBQuerySmpConstRef` query , `AEECLSID` id , `SFCErrorPtr` exception = null ) (SFBBase から継承) 指定したクラス ID のインターフェースのインスタンスを指定した SFBQuery インスタンスを使用して生成します。

SFBPosDet::ExtractPositionInfo

AEEGPSInfo で指定された位置について、AEEPositionInfoEx で指定される形式で位置情報を生成します。

[ public ]
SFCError ExtractPositionInfo(
    AEEGPSInfo* gps               AEEGPSInfo データへのポインタ
    AEEPositionInfoEx* position   位置情報の出力バッファ
);

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_POS_LOCATION)を持っていないとき: EPRIVLEVEL
引数 gps または position が null であるとき: SFERR_INVALID_PARAM
この関数がデバイスでサポートされていないとき: SFERR_UNSUPPORTED
失敗したとき: SFERR_FAILED

バージョン

この関数は、BREW 3.0 から使用可能です

参照

BREW API IPOSDET_ExtractPositionInfo | AEEGPSInfo

SFBPosDet::GetGPSConfig

GPS エンジンの現在の GPS 構成を取得します。

[ public ]
SFCError GetGPSConfig(
    AEEGPSConfig* config   // GPS 構成へのポインタ
                           // 詳細は、AEEGPSConfig を参照
);

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_POS_LOCATION)を持っていないとき: EPRIVLEVEL
引数 config が null であるとき: SFERR_INVALID_PARAM
この関数がデバイスでサポートされていないとき: SFERR_UNSUPPORTED

参照

BREW API IPOSDET_GetGPSConfig | AEEGPSConfig | SFBPosDet::SetGPSConfig

SFBPosDet::GetGPSInfo

GPS に基づく位置情報を取得します。

[ public ]
SFCError GetGPSInfo(
    AEEGPSReq request         
    AEEGPSAccuracy accuracy   
    AEEGPSInfo* info          
    SFXCallbackPtr callback   
);

引数

request: 要求タイプ: AEEGPS_GETINFO_LOCATION AEEGPS_GETINFO_VELOCITY AEEGPS_GETINFO_ALTITUDE 。フラグを組み合わせて複数のタイプの情報を指定できる。
accuracy: この要求に選択された精度レベル。
info: 入力時は、AEEGPSInfo 構造体への有効なポインタを指定する。コールバックでは、この構造体のメンバに GPS 情報が含まれる。 callback で指定したコールバックがコールされるまでこの構造外が有効であることをコール側で保証する必要がある。
callback: ポジション決定完了時にコールされるコールバック関数。

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_POS_LOCATION)を持っていないとき: EPRIVLEVEL
引数 info または callback が null か引数 accuracy が無効であるとき: SFERR_INVALID_PARAM
指定した AEEGPSReq 要求タイプまたは AEEGPSAccuracy 精度がデバイスの GPS エンジンでサポートされていないとき: SFERR_UNSUPPORTED
メモリ不足のとき: SFERR_INVALID_MEMORY
失敗したとき: SFERR_FAILED

参照

BREW API IPOSDET_GetGPSInfo | AEEGPSInfo | AEECallback

SFBPosDet::GetOrientation

水平面上のデバイスの方角を取得します。

[ public ]
SFCError GetOrientation(
    AEEOrientationReq orientation   
    VoidPtr info                    
    SFXCallbackPtr callback         
);

[ public ]
SFCError GetOrientation(
    AEEOrientationReq orientation   
    SFXBufferPtr info               // null の場合、何もせずに SFERR_INVALID_PARAM を返す
    SFXCallbackPtr callback         
);

引数

orientation: 要求する情報
info: バッファ。最初の２バイトにサイズを代入しておく。 callback で指定したコールバックがコールされるまでこのポインタが有効であることをコール側で保証する必要がある。
callback: ポジション決定完了時にコールされるコールバック関数。

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_POS_LOCATION)を持っていないとき: EPRIVLEVEL
引数 info または callback が null であるとき: SFERR_INVALID_PARAM
この関数がデバイスでサポートされていないとき: SFERR_UNSUPPORTED
pCB ポインタが無効でとき: EMEMPTR
失敗したとき: SFERR_FAILED

バージョン

この関数は、BREW 2.1 から使用可能です。

参照

BREW API IPOSDET_GetOrientation

SFBPosDet::GetSectorInfo

セクターに基づくポジションロケーション情報、たとえば、システム ID、ネットワーク ID、基地局 ID、基地局クラス、ベストパイロットなどを取得します。

[ public ]
SFCError GetSectorInfo(
    AEESectorInfo* info   // AEESectorInfo 構造体へのポインタ
);

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_SECTORINFO)を持っていないとき: EPRIVLEVEL
この関数がデバイスでサポートされていないとき: SFERR_UNSUPPORTED
引数 info が null であるとき: SFERR_INVALID_PARAM
失敗したとき: SFERR_FAILED

参照

BREW API IPOSDET_GetSectorInfo | AEESectorInfo

SFBPosDet::NewInstance

SFBPosDet インスタンスを生成します。

[ public, static ]
SFBPosDetSmp NewInstance(
    SFCErrorPtr exception = null   // エラー値
);

[ public, static ]
SFBPosDetSmp NewInstance(
    AEECLSID id                    // クラスID
    SFCErrorPtr exception = null   // エラー値
);

SFBPosDet::SetGPSConfig

GPS エンジンが使う GPS 構成を設定します。

[ public ]
SFCError SetGPSConfig(
    AEEGPSConfig* config   // GPS 構成へのポインタ
                           // 詳細情報 : AEEGPSConfig
);

戻り値

成功したとき: SFERR_NO_ERROR
mif ファイルが特権レベル(PL_POS_LOCATION)を持っていないとき: EPRIVLEVEL
引数 config が null であるとき: SFERR_INVALID_PARAM
この関数がシステムでサポートされていないとき: SFERR_UNSUPPORTED

参照

BREW API IPOSDET_SetGPSConfig | AEEGPSConfig | SFBPosDet::GetGPSConfig

SFBPosDet::WGS84ToDegrees

WGS84 回転楕円形式の緯度または経度を 10 進度形式に変換します。

[ public, static ]
Float64 WGS84ToDegrees(
    SInt32 latlon   // WGS-84 回転楕円座標で表現した緯度または経度
);

戻り値

10 進度形式による緯度または経度。

解説

SFBPosDet::GetGPSInfo 関数で取得した緯度と経度を変換するために使います。

バージョン

この関数は、BREW 2.1 から使用可能です。

参照

BREW API WGS84_TO_DEGREES | SFBPosDet::GetGPSInfo