类 TencentGeofence


  • public class TencentGeofence
    extends java.lang.Object
    地理围栏.

    地理围栏表示一片地理位置区域, 用户设备进入或退出该区域后会触发相应的地理围栏事件, 应用程序可捕获感兴趣的地理围栏事件并执行相应操作(比如通过声音或振动提示用户).

    地理围栏支持圆形地理围栏和多边形地理围栏两种。 公共参数包括:

    • Tag: 唯一的字符串. 用于标识和区分当前各个已设置的地理围栏
    • 有效期: 单位为 ms(毫秒). 超过有效期的围栏会被自动清除, 应根据使用场景选择合理的值, 建议取值 3-6小时
    • 类型:包括Circle和Polygon两种类型
    圆形地理围栏参数包括:
    • 中心点坐标: GCJ-02 坐标系下经纬度. 用于指定目的地的精确位置
    • 半径: 表示区域大小, 单位为 m(米). 考虑到实际定位精度水平, 建议取值 500-1500米
    多边形地理围栏参数包括:
    • 边界坐标点 :GCJ-02 坐标系下经纬度边界坐标,最少传3个,且不能重复经纬度
    • 字段详细资料

      • GEOFENCE_TYPE_CIRCLE

        public static final int GEOFENCE_TYPE_CIRCLE
        另请参阅:
        常量字段值
      • GEOFENCE_TYPE_POLYGON

        public static final int GEOFENCE_TYPE_POLYGON
        另请参阅:
        常量字段值
    • 方法详细资料

      • getLatitude

        @Deprecated
        public double getLatitude()
        已过时。
        返回纬度 仅当Type为GEOFENCE_TYPE_CIRCLE有效 废弃,建议使用getCircleFence.getLatitude
      • getLongitude

        @Deprecated
        public double getLongitude()
        已过时。
        返回经度 仅当Type为GEOFENCE_TYPE_CIRCLE有效 废弃,建议使用getCircleFence.getLongitude
      • getRadius

        @Deprecated
        public float getRadius()
        已过时。
        返回半径, 单位为 m(米) 仅当Type为GEOFENCE_TYPE_CIRCLE有效 废弃,建议使用getCircleFence.getRadius
      • getCircleFence

        public TencentGeofence.CircleFence getCircleFence()
        返回圆形围栏对象 仅当Type为GEOFENCE_TYPE_CIRCLE有效
      • getPolygonFence

        public TencentGeofence.PolygonFence getPolygonFence()
        返回多边形围栏对象 仅当Type为GEOFENCE_TYPE_POLYGON有效
      • getExpireAt

        public long getExpireAt()
        返回过期时间, 过期时间 = 有效期 + SystemClock.elapsedRealtime()
        另请参阅:
        SystemClock.elapsedRealtime()
      • getDuration

        public long getDuration()
        返回有效期, 单位为 ms(毫秒).
      • getTag

        public java.lang.String getTag()
        返回唯一标识.
      • equals

        public boolean equals​(java.lang.Object obj)
        覆盖:
        equals 在类中 java.lang.Object
      • hashCode

        public int hashCode()
        覆盖:
        hashCode 在类中 java.lang.Object
      • toString

        public java.lang.String toString()
        覆盖:
        toString 在类中 java.lang.Object