跳到主要内容

egret.GeolocationEvent

包    egret

类    public class GeolocationEvent

继承    egret.GeolocationEvent → egret.Event → egret.HashObject

GeolocationEvent 提供设备的地理位置信息和获取位置时发生的错误信息

公共属性​

属性
PERMISSION_DENIED : string
[静态]由于用户拒绝访问位置信息，获取位置信息失败
UNAVAILABLE : string
[静态]设备位置服务不可用或者超时等原因没有得到位置信息
accuracy : number
经纬度的准确性，单位是米
altitude : number
该位置的海拔信息，如果设备没有实现这个属性时，这个值有可能为 null
altitudeAccuracy : number
该位置海拔信息的准确性，单位是米，这个值有可能为 null
errorMessage : string
获取位置信息错误的错误信息
errorType : string
获取位置信息错误时的错误类型
heading : number
表示设备正在前进的方向，单位是度
latitude : number
当前位置的纬度信息
longitude : number
当前位置的经度信息
speed : number
当前设备的速度 单位是 米/秒，这个值可能为 null

公共方法​

方法

属性详细信息​

PERMISSION_DENIED​

PERMISSION_DENIED : string = "permissionDenied"

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

由于用户拒绝访问位置信息，获取位置信息失败

UNAVAILABLE​

UNAVAILABLE : string = "unavailable"

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

设备位置服务不可用或者超时等原因没有得到位置信息

accuracy​

accuracy : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

经纬度的准确性，单位是米

altitude​

altitude : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

该位置的海拔信息，如果设备没有实现这个属性时，这个值有可能为 null

altitudeAccuracy​

altitudeAccuracy : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

该位置海拔信息的准确性，单位是米，这个值有可能为 null

errorMessage​

errorMessage : string

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

获取位置信息错误的错误信息

errorType​

errorType : string

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

获取位置信息错误时的错误类型。值可能为：

heading​

heading : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

表示设备正在前进的方向，单位是度。heading 表示从正北开始顺时针旋转到当前方向的角度，比如正东是 90 度，正西是 270 度，如果 speed 是 0，heading 为 NaN。

latitude​

latitude : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

当前位置的纬度信息

longitude​

longitude : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

当前位置的经度信息

speed​

speed : number

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

当前设备的速度 单位是 米/秒，这个值可能为 null

方法详细信息​

示例​

class  GeolocationExample  extends  egret.DisplayObjectContainer  {
 label: egret.TextField;
  constructor()  {
    super();
    this.label  =  new  egret.TextField();
    this.label.y  =  50;
    this.label.x  =  50;
    this.addChild(this.label);
    var gps =  new  egret.Geolocation(); gps.addEventListener(egret.Event.CHANGE,this.onGotLocation,this);
    gps.start();
  }
  onGotLocation(e:egret.GeolocationEvent){
    this.label.text  =  "当前位置:"+e.latitude.toFixed(1)+","+e.longitude.toFixed(1);
  }
}