次の方法で共有

ILatLongReport::GetAltitude メソッド (locationapi.h)

  • [アーティクル]

[Win32 Location API は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 Windows.Devices.Geolocation API を使用します。 ]

高度をメートル単位で取得します。 高度は参照楕円体に対して相対的です。

構文

HRESULT GetAltitude(
  [out] DOUBLE *pAltitude
);

パラメーター

[out] pAltitude

高度を受け取る DOUBLE のアドレス (メートル単位)。 NULL を指定できます。

戻り値

有効な値を次の表に示しますが、これ以外にもあります。

戻り値 説明
S_OK
 メソッドから正常に値が返されました。
HRESULT_FROM_WIN32(ERROR_NO_DATA)
 場所レポートには、要求されたフィールドのデータは含まれません。 この結果は、位置センサーが高度をサポートしていない場合に返されます。

注釈

GetAltitude メソッドは、海面に対する高度ではなく、世界測地システム (WGS 84) の最新リビジョンで定義されている参照楕円体に対する高度を取得します。

例

次のコード例は、 GetAltitude を呼び出す方法を示しています。 高度は緯度/経度レポートの省略可能なフィールドであるため、 GetAltitude は常にデータを返すわけではありません。

DOUBLE altitude = 0;
// Print the Altitude
if (SUCCEEDED(spLatLongReport->GetAltitude(&altitude)))
{
    wprintf(L"Altitude: %f\n", altitude);
}
else
{
    // Altitude is optional and may not be available
    wprintf(L"Altitude: Not available.\n");
}

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ],Windows 7
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー locationapi.h
[DLL] LocationAPI.dll

こちらもご覧ください

ILatLongReport