このドキュメントでは、WVLocation クラスの JSAPI について説明します。H5 アプリケーションやミニプログラムを作成する際のリファレンスとして利用できます。これらの JSAPI を使用すると、位置情報を検索および取得できます。
WVLocation.getLocation
現在地を取得します。
iOS 8 以降、Apple はアプリケーションに対する位置情報権限の要件を変更しました。位置情報権限のプロンプトを表示するには、アプリケーションの
Info.plistファイルにNSLocationWhenInUseUsageDescriptionキーとNSLocationAlwaysUsageDescriptionキーを追加する必要があります。iOS 11 以降では、位置情報権限のプロンプトを表示するために、
Info.plistファイルにNSLocationAlwaysAndWhenInUseUsageDescriptionキーとNSLocationWhenInUseUsageDescriptionキーの両方を追加する必要があります。
入力パラメーター
enableHighAccuracy([boolean]、任意)：高精度な位置情報を取得するかどうかを指定します。有効な値はtrueとfalseです。デフォルト値はfalseです。address([boolean]、任意)：「中国、杭州」などの住所情報を取得するかどうかを指定します。住所情報をリクエストしない場合、座標はより迅速に返されます。デフォルト値はfalseです。
コールバックパラメーター
操作が成功した場合、success コールバックが次のパラメーターで呼び出されます。それ以外の場合は、failure コールバックが呼び出されます。
coords([object])：座標情報。longitude([string])：経度。latitude([string])：緯度。accuracy([string])：水平精度。
address([object])：住所情報。city([string])：市。province([string])：省。area([string])：地域。road([string])：道路。addressLine([string])：住所の詳細。cityCode([string])：市コード。Android では、Google の位置情報データにこのフィールドが含まれていないため、このフィールドは Taobao クライアントでのみ利用可能です。
位置情報の精度や基盤となる API の違いにより、返される住所情報が不完全または不正確である場合があります。ご利用の H5 クライアントは、これらの潜在的なデータの不整合に対応する必要があります。
var params = {
// 高精度な位置情報を取得するかどうか
enableHighAccuracy: true,
// 住所情報を取得するかどうか
address: true
};
window.WindVane.call('WVLocation', 'getLocation', params, function(e) {
alert('success:' + JSON.stringify(e));
}, function(e) {
alert('failure:' + JSON.stringify(e));
});
WVLocation.searchLocation
この API は WindVane for iOS でのみ利用可能です。
指定された住所の座標を検索します。
入力パラメーター
addrs([string])：検索する住所。
コールバックパラメーター
操作が成功した場合、success コールバックが次のパラメーターで呼び出されます。それ以外の場合は、failure コールバックが呼び出されます。
longitude([string])：経度。latitude([string])：緯度。
var params = {
// 検索対象のアドレス
addrs: '960 West xxxx Road'};
window.WindVane.call('WVLocation', 'searchLocation', params, function(e) {
alert('成功:' + JSON.stringify(e));
}, function(e) {
alert('失敗:' + JSON.stringify(e));
});