Geolocation 外部オブジェクト

警告: Maps 外部オブジェクトは、Geolocation 外部オブジェクトよりも新しいオブジェクトです。両方の外部オブジェクトで提供されているメソッドとプロパティの多くは似ています。異なる点は、Maps 外部オブジェクトが Geography データタイプを使用しているのに対し、Geolocation 外部オブジェクトは Geolocation ドメイン (非推奨) を使用していることです。また、Maps 外部オブジェクトにはより多くの機能が含まれています。Maps 外部オブジェクトと Geography データタイプを使用することを強くお勧めします。

この API を使用すると、該当するネイティブモバイルアプリケーションが実行されているデバイス上の GPS とやり取りすることによって、それらのアプリケーションに対応するロケーションサービスを提供できます。
この API によって要件を解決できるシナリオについては、「Geolocation API - シナリオ」を参照してください。この API を使用できるようにするために、多くのメソッドが定義されており、GeoLocationInfo と呼ばれる Structured Data Type (SDT) オブジェクトも定義されています。

戻り値	GeolocationInfo
パラメーター	minAccuracy:Numeric(8.0), timeout:Numeric(8.0), IncludeHeadingAndSpeed:Boolean [ , ignoreErrors:Boolean ]

Authorized メソッド *

ロケーションサービスを使用するためのアクセス許可がアプリケーションに付与されているかどうかを示します。

戻り値	Boolean
パラメーター	なし

ServiceEnabled メソッド *

ロケーションサービスがデバイスで有効になっているかどうかを示します。

戻り値	Boolean
パラメーター	なし

StartTracking メソッド *

追跡情報の生成を開始します。追跡に関する記事を参照してください。

戻り値	なし
パラメーター	changeInterval:Numeric(8.0), distance:Numeric(8.0), action:Character(20), actionTimeInterval:Numeric(8.0) [ , accuracy:Numeric(8.0) ]

EndTracking メソッド *

追跡情報の生成を停止します。追跡に関する記事を参照してください。

戻り値	なし
パラメーター	なし

GetLocationHistory メソッド

追跡用のメソッドによって生成された位置情報のコレクションを返します。追跡に関する記事を参照してください。

戻り値	GeolocationInfo
パラメーター	startTime:DateTime

ClearLocationHistory メソッド

追跡用のメソッドによって以前に生成された位置情報をすべて削除します。追跡に関する記事を参照してください。

戻り値	なし
パラメーター	なし

GetLatitude メソッド *

指定した位置の緯度を返します。

戻り値	Numeric(9.5)
パラメーター	location:Geolocation

GetLongitude メソッド *

指定した位置の経度を返します。

戻り値	Numeric(9.5)
パラメーター	location:Geolocation

GetDistance メソッド

指定した 2 つの位置間の距離を返します。

戻り値	GeolocationInfo
パラメーター	fromLocation:Geolocation, toLocation:Geolocation

GetAddress メソッド

指定した位置の住所のコレクションを返します。

戻り値	Collection( Address )
パラメーター	location:Geolocation ドメイン

適切に動作させるには、環境レベルでの [ Google API Key ] プロパティに有効な Google API キーを設定する必要があります。

GetLocation メソッド

警告: Maps 外部オブジェクトの GeocodeAddress メソッドは、Geolocation 外部オブジェクトの GetLocation メソッドと同じ動作を実行します。Maps 外部オブジェクトを使用することを強くお勧めします。

指定した住所の位置のコレクションを返します。

戻り値	Collection( Geolocation )
パラメーター	address:Address

適切に動作させるには、環境レベルでの [ Google API Key ] プロパティに有効な Google API キーを設定する必要があります。

SetProximityAlerts メソッド *

一連の近接アラートを設定し、操作の成否を返します。「位置情報近接アラートを使用する方法」を参照してください。

戻り値	Boolean
パラメーター	proximityAlerts: Collection( GeolocationProximityAlerts )

GetProximityAlerts メソッド *

設定されている近接アラートのリストを取得します。「位置情報近接アラートを使用する方法」を参照してください。

戻り値	proximityAlerts: Collection( GeolocationProximityAlerts )
パラメーター	なし

GetCurrentProximityAlert メソッド *

現在の近接アラートの情報を取得します。「位置情報近接アラートを使用する方法」を参照してください。

戻り値	GeolocationProximityAlerts
パラメーター	なし

ClearProximityAlerts メソッド *

設定されている近接アラートのリストをクリアします。「位置情報近接アラートを使用する方法」を参照してください。

戻り値	なし
パラメーター	なし

PickLocation メソッド

位置を選択します。

戻り値	なし
パラメーター	GeolocationPickerParameters:GeolocationPickerParameters

近接アラート関連のメソッドは iOS でのみ利用可能です。
iOS では、追跡および近接アラート関連のメソッドをバックグラウンドモードで使用するには、そのためのアクセス許可が必要です。これに対応するには、 [ Background Modes ] プロパティに値 location を追加します。また、位置の更新を遅延させて、バッテリーの消費を抑えることができます。
iOS 8.0 以降では、ロケーションサービスを使用する際に、 [ Location Always Usage Description ] プロパティまたは [ Location When In Use Usage Description ] プロパティの値を指定する必要があります。

適用範囲

ジェネレーター:

Apple、Android

動画

Events in Mobile Applications

プロパティ

AuthorizationStatus

メソッド

GetMyLocation メソッド *