Android SDK | 腾讯位置服务

资源下载

TencentMapSDK_Android_3D_v4.3.3

2020-03-18 TencentMapSDK_3D_v4.3.3

审图号：GS(2018)2236号

maven 地址

repositories {
  maven{
    url "https://oss.sonatype.org/content/groups/public"
  }
}
//module 依赖
dependencies {
  // 地图库
  implementation 'com.tencent.map:tencent-map-vector-sdk:4.3.3.2'
  // 地图兼容库
  implementation 'com.tencent.map:sdk-compat-v4:4.3.3.2'
}

新增

1. 支持开发者设置自定义的 userid:

接口	说明
`TencentMapOptions.setCustomUserID(String cuid)`	开发者可设置此 id，方便线上问题跟进

2. 支持交通事件展示功能

优化

1. 比例尺单位使用中文

2020-02-12 TencentMapSDK_3D_v4.3.2

审图号：GS(2018)2236号

maven 地址

repositories {
  maven{
    url "https://oss.sonatype.org/content/groups/public"
  }
}
//module 依赖
dependencies {
  // 地图库
  implementation 'com.tencent.map:tencent-map-vector-sdk:4.3.2'
  // 地图兼容库
  implementation 'com.tencent.map:sdk-compat-v4:4.3.2'
}

新增

1. 个性化图层能力开放，使用前需要用户在地图官网上传数据，审核通过后方可使用。

优化

1. 优化地图配置，减少地图显示异常情况；

修改

1. 解决 TileOverlay 移除时小概率出现空指针的问题；
2. 废弃 Marker.setInMapCenterState，不再维护接口功能，后续版本不再保证该接口可用性。

2019-12-18 TencentMapSDK_3D_v4.3.1

审图号：GS(2018)2236号

maven 地址

repositories {
  maven{
    url "https://oss.sonatype.org/content/groups/public"
  }
}
//module 依赖
dependencies {
  // 地图库
  implementation 'com.tencent.map:tencent-map-vector-sdk:4.3.1'
  // 地图兼容库
  implementation 'com.tencent.map:sdk-compat-v4:4.3.1'
}

优化

1. 暗色模式效果优化，海外图支持暗色模式，比例尺、指南针等地图内置控件支持暗色模式；

修改

1. 废弃接口：

TencentMap.isBlockRouteEnabled

TencentMap.setBlockRouteEnabled

UiSettings.setZoomPosition

UiSettings.setZoomControlsEnabled

UiSettings.isZoomControlsEnabled

2019-11-27 TencentMapSDK_3D_v4.3.0

审图号：GS(2018)2236号

maven 地址

repositories {
  maven{
    url "https://oss.sonatype.org/content/groups/public"
  }
}
//module 依赖
dependencies {
  // 地图库
  implementation 'com.tencent.map:tencent-map-vector-sdk:4.3.0'
  // 地图兼容库
  implementation 'com.tencent.map:sdk-compat-v4:4.3.0'
  // 地图工具包
  implementation 'com.tencent.map:sdk-utilities:1.0.5'
}

优化

1、解决无障碍模式下的 crash 问题
2、解决 infowindow 未保存室内状态问题
3、解决 ViewInfowindow 刷新时的空指针问题
4、解决 LineText 在 armv7a 架构上无法移除问题

修改

1. 解决已知问题，提高稳定性；

新增

1. 统一底图类型入口 TencentMap.setMapType(int mapType)，底图类型目前共三种：TencentMap.MAP_TYPE_NORMAL、TencentMap.MAP_TYPE_DARK、TencentMap.MAP_TYPE_SATELLITE;
2. 废弃 TencentMap.setSatelliteEnabled(boolean enable)，请使用 TencentMap.setMapType(TencentMap.MAP_TYPE_SATELLITE);
3. 废弃 TencentMap.isSateLiteEnable(), 请使用 TencentMap.getMapType();

2019-11-13 TencentMapSDK_3D_v4.2.9

maven 地址

url "https://oss.sonatype.org/content/groups/public"
地图库
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.9'
地图兼容库
implementation 'com.tencent.map:sdk-compat-v4:4.2.9'
地图工具包
implementation 'com.tencent.map:sdk-utilities:1.0.5'

修改

1. 解决已知问题，提高稳定性；

新增

1. 发布地图工具包，支持点聚合和 marker 平移动画；

2019-10-16 TencentMapSDK_3D_v4.2.8

maven 地址

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.8'
地图兼容库:
implementation 'com.tencent.map:sdk-compat-v4:4.2.8'

修改

1. 解决 Android Q 可能白屏的问题；
2. 解决已知问题，提高稳定性；

优化

1. 优化 InfoWindowAdapter 处理逻辑；

2019-09-04 TencentMapSDK_3D_v4.2.7

maven 地址

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.7'
地图兼容库:
implementation 'com.tencent.map:sdk-compat-v4:4.2.7'

新增

1. 支持沿 polyline 展示的文字功能

接口	说明
PolylineOptions.text(Text text)	沿创建的 polyline 展示文字，满足导航场景下动态路名需求。注：只要调用 TencentMap.addPolyline(PolylineOptions) 构造出 Polyline 实例就不可以再调用 Polyline.setPoints(List) 修改 Text 展示的路径，只能创建新的 Polyline

Text 支持的属性：

接口	说明
Builder.color(int color)	颜色
Builder.strokeColor(int color)	描边颜色
Builder.size(int size)	文字大小
Builder.priority(TextPriority priority)	文字间优先级关系

2. 支持 ipv6

修改

1. 解决单指双击缩放地图时级别变化不连贯问题;
2. 解决 ViewInfowindow 不能移除问题。从这个版本开始，用户在使用 InfoWindowAdapter 返回自定义的 view 时，应保证每个 marker 返回自己的 infowindow view;
3. 修复 onCameraChangeFinish 回调可能返回多次问题；

优化

1. Polyline 置灰接口效率优化，避免出现闪烁现象；
2. 优化 sdk 包体积。其中资源文件 20k；精简 so 库 200 k，代码段精简 11%；

2019-08-14 TencentMapSDK_3D_v4.2.6.2

maven 地址

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.6.2'
地图兼容库:
implementation 'com.tencent.map:sdk-compat-v4:4.2.6.2'

新增

1. 限制地图区域

接口	说明
TencentMap.setRestrictBounds(LatLngBounds restrictBounds, RestrictBoundsFitMode fitMode)	此接口同时会限制地图的最小缩放级别，用户还可以通过 {@link TencentMap#setMinZoomLevel(int)} 修改自己需要的最小缩放级别获取需要的展示效果

RestrictBoundsFitMode 为用户提供了两种限制屏幕中区域的方式：

枚举	说明
FIT_WIDTH	此模式会以 bounds 宽度为参考值限制地图的控制区域，在最小限制级别时 bounds 的纵向区域可能显示不完整, 可调用 TencentMap.setMinZoomLevel(int) 修改最小限制级别以展示完整的区域
FIT_HEIGHT	此模式会以 bounds 高度为参考值限制地图的控制区域，在最小限制级别时 bounds 的横向区域可能显示不完整, 可调用 TencentMap.setMinZoomLevel(int) 修改最小限制级别以展示完整的区域

修改

1. Android Q 兼容性优化
2. 当用户通过 CameraUpdateFactory.newLatLngBounds 获取到的 CameraUpdate 为参数调用 TencentMap.moveCamera 或 TencentMap.animateCamera 接口修改地图视野时，不再修改地图的旋转角度和倒伏角度。
3. 修复与导航 sdk 兼容性问题
4. 解决已知问题，提高稳定性

优化

1. 精简 sdk 体积，降低 9%

2019-07-24 TencentMapSDK_3D_v4.2.5

maven 地址

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.5'

新增

1. 支持 ViewInfoWindow，marker 的 infoWindow 可以直接以 view 实现。开发者可通过该接口在infoWindow中添加Gif或View动画。
接口名称:MarkerOptions.viewInfoWindow(boolean enabled)
接口说明:设置此 marker 的 infoWindow 是否用 view 实现 infoWindow
2. 添加检索功能地图数据检索能力封装了 lbs.qq.com 提供的 webservice 接口, 上线使用时应先申请配额，避免因配额问题导致的 app 异常。目前地图 sdk 提供的检索功能包括
• 地点搜索
• 关键词输入提示
• 逆地址解析（坐标位置描述）
• 地址解析（地址转坐标）
• 行政区划
• 坐标转换
• 路线规划服务

修改

1. 热力图接口标准化开放，如果用户希望使用旧版热力图接口可引入腾讯地图兼容库 tencent-mapsdk-compat-v4 包。用户可使用压缩包中提供的 jar 包或者使用 maven 引入项目
依赖库名称：
implementation 'com.tencent.map:sdk-compat-v4:4.2.5'
用户需要使用 tencent-mapsdk-compat-v4 库中提供的 compat 类才能调用 comapt 库中提供的各种兼容方法，主要类的对应关系如下：

原始类	兼容类
MapFragment	MapFragmentCompat
MapRenderLayer	MapRenderLayerCompat
MapView	MapViewCompat
SupportMapFragment	SupportMapFragmentCompat
TencentMap	TencentMapCompat
TextureMapView	TextureMapViewCompat

优化

1.3D室内图展现效果优化，欢迎开发者合作接入，详情可查看室内位置服务解决方案。

2019-06-17 TencentMapSDK_3D_v4.2.4

maven 地址

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
implementation 'com.tencent.map:tencent-map-vector-sdk:4.2.4'

新增

1. 支持自定义字体
2. TileOverlay 接口

修改

1. 线宽默认为 9dp
2. 适配 Android Q
3. 修改指南针开关行为，不再与地图状态关联；指南针样式修改
影响接口：
设置是否显示指南针
@param flag 是否显示：true 显示 false 隐藏
public void setCompassEnabled(boolean flag)
4. 3d 楼块展示效果开关不再与地图状态关联；
影响接口：
设置是否显示3D建筑
@param use3DStyle 是否使用3D的模式绘制楼快，默认是true
public void setBuildingEnable(boolean use3DStyle)

2019-04-28 TencentMapSDK_3D_v4.2.3.1

修改

1. 修改 support 库版本为 28.0.0

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.2.3.1'；

2019-03-25 TencentMapSDK_3D_v4.2.3

新增

1. 步行路线规划功能，详细说明参见 javadoc com.tencent.lbssearch 包下的接口

1) 获取路线规划接口：
TencentSearch.getRoutePlan(RoutePlanningParam param, HttpResponseListener listener)：
2) 步行路线规划参数设置：
RoutePlanningParam.from(LatLng from)
RoutePlanningParam.to(LatLng to)
3) 步行路线规划结果：
WalkingResultObject.Result 使用方法参见 demo。

修改

1. 修复已知问题，提高稳定性

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.2.3'；

2019-01-28 TencentMapSDK_3D_v4.2.2

新增

1. Polyline 支持设置擦除颜色 PolylineOptions.eraseColor(int eraseColor)

修改

1. 解决已知问题，提高稳定性

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.2.2'；

2018-12-24 TencentMapSDK_3D_v4.2.1

修改

1. 升级渲染引擎
2. 升级路况服务，减少流量，提高准确度
3. poi 文字可点，提高底图 poi 选中成功率
4. 同层渲染&TextureMapView帧率优化
5. 最大级别调整为20级
6. 比例尺显示级别与IOS对齐，添加消失动画
7. 修复已知问题，提高稳定性

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.2.1'；

2018-10-15 TencentMapSDK_3D_v4.1.4.1

新增

1、支持无障碍

修改

1. 优化地图抛掷手势，延长动画时间
2. 手指落下时，停止地图视野动画
3. 解决已知问题，提高稳定性

2018-09-13 TencentMapSDK_3D_v4.1.3

新增

1、支持个性化地图配置

修改

1. 优化 onCamreaChange 回调

2018-08-31 TencentMapSDK_3D_v4.1.2

修改

1. 适配 Android P
2. 修复已知问题，提高稳定性

2018-08-06 TencentMapSDK_3D_v4.1.1

新增

1. infoWindow 支持偏移
MarkerOptions.infoWindowOffset(int offsetX, int offsetY)
newLatLngBounds并保持中心点不变接口
CameraUpdateFactory.newLatLngBoundsWithMapCenter(LatLngBounds latLngBounds, LatLng mapCenter, int padding)

2018-07-09 TencentMapSDK_3D_v4.1.0

新增

1. 提供多 infowindow 开关接口

1）TencentMap.enableMultipleInfowindow(boolean isEnable)
2）TencentMapOptions.setMultipleInfoWindowEnable(boolean isEnable);

修改

1. 修改设置纹理线方法，支持通过 BitmapDescriptor 设置纹理

PolylineOptions.colorTexture(BitmapDescriptor bitmapDescriptor)

2. 修复已知问题，提高稳定性

2018-06-07 TencentMapSDK_3D_v4.0.10.1

新增

1.TecentMap

1）提供根据指定地图覆盖物缩放到合适地图范围接口:
public CameraPosition calculateZoomToSpanLevel(List elements, List points, int leftPadding, int rightPadding, int topPadding, int bottomPadding)；

2.UiSettings

1）提供 logo 缩放接口：
public void setLogoScale(float logoScale)；
2）提供 logo 位置修改接口：
public final void setLogoPosition(int logoAnchor , int[] marginParams)；

3.MarkerOption

1）提供 marker 快速加载接口：
public void fastLoad(boolean fastLoad)；

修改

1. 优化网络
2. 修复已知问题，提高稳定性

2018-04-27 TencentMapSDK_3D_v4.0.9

修改

1. 修复已知问题，提高稳定性

2018-03-08 TencentMapSDK_3D_v4.0.8.1

修改

1. 修改样式更新逻辑
2. 其他已知问题修复，提高稳定性

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.0.8.1'；

2018-01-16 TencentMapSDK_3D_v4.0.7.1

修改

1. 默认关闭封路效果

2018-01-08 TencentMapSDK_3D_v4.0.7

新增

1. 增加封路展示
TencentMap 类：
setBlockRouteEnabled(boolean enable)
isBlockRouteEnabled()
2. 增加设置是否以中心点缩放的接口
UiSettings类
setGestureScaleByMapCenter(boolean scaleByMapCenter)

修改

1. 修改地图 logo
2. 其他已知问题修复

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.0.7'；

2017-12-04 TencentMapSDK_3D_v4.0.5.1

修改

1.修复一个内存泄漏；

maven 地址：

url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.0.5.1'；

2017-11-27 TencentMapSDK_3D_v4.0.5

修改

1.修复已知问题；

2017-10-12 TencentMapSDK_3D_v4.0.3.2

新增

1.新增 maven 配置腾讯地图sdk方式

maven 地址：
url "https://oss.sonatype.org/content/groups/public"
依赖库名称：
compile 'com.tencent.map:tencent-map-vector-sdk:4.0.3.2'；

修改

1.修改 logo；

2017-09-18 TencentMapSDK_3D_v4.0.3.1

修改

1.修复偶现崩溃；

2017-09-04 TencentMapSDK_3D_v4.0.3

修改

1.onCameraChangeFinished 回调接口表现改为只有手指离开地图才会回调；
2.修复其他 bug；

2017-08-11 TencentMapSDK_3D_v4.0.2

新增

1.LocationSource 定位三态；
2.Polyline 增加描边支持；
3.Polyline 增加虚线绘制支持；
4.缩放级别最大由 19 级调整为 20 级；

修改

1.修复部分手机截图问题；
2.优化性能；
3.OnMapLoaded 回调强制在主线程回调；
4.修复 newLatLngBoundsRect 显示不正确问题；
5.缩小 logo 默认尺寸；
6.图形绘制长度单位由 dp 调整为 px;

2017-06-19 TencentMapSDK_3D_v4.0.0

4.0.0版全新重构，性能、稳定性全面提升。

修改

1、TecentMap

1）TencentMap.DataFetcher接口去除；
2）TencentMap.InfoWindowAdapter接口中，去除了 View getInfoWindowPressState(Marker marker)接口；
3）TencentMap.OnMyLocationButtonClickListener接口去除；
4）TencentMap.ScreenShotReadyCallback接口改变为TencentMap.SnapshotReadyCallback；
5）animateToNaviPosition/animateToNaviPosition2相关接口的去除；
6）calcuteZoomToSpanLevel接口去除；
7）calNaviLevel/calNaviLevel2接口去除；
8）getScreenShot(TencentMap.ScreenShotReadyCallback)接口改变为snapshot(SnapshotReadyCallback)接口；
9）getScreenShot(TencentMap.ScreenShotReadyCallback，Bitmap.Config)接口改变为snapshot(SnapshotReadyCallback,Bitmap.Config)接口；
10）setCompassExtraPadding(int)接口去除；
11）setDataFetcher(TencentMap.DataFetcher)接口去除；
12）setNaviFixingProportion(float, float)/setNaviFixingProportion2D(float, float)接口去除；
13）setOnMyLocationButtonClickListener(TencentMap.OnMyLocationButtonClickListener)接口去除；

2、CameraUpdateFactory

1）CameraUpdate newLatLngBounds(LatLngBounds, int, int, int)接口去除；

3、MapFragment

1）去除MapFragment newInstance(android.content.Context)/MapFragment newInstance(TencentMapOptions,android.content.Context)接口；

4、SupportMapFragment

1）SupportMapFragment newInstance(TencentMapOptions, android.content.Context接口去除；

5、TencentMapOptions

1）TencentMapOptions目前为一些常量值的存储类，包括比例尺、logo以及缩放控件的位置常量；

６、UiSettings

1）void showScaleView(boolean)改为setScaleViewEnabled(boolean)；

7、NetUtil

1）UpdateTrafficTimer接口去除；

8、CameraPosition.Builder

1）rotate(float)改变为 bearing(float)；
2）skew(float)改变为tilt(float)；

9、Marker

1）float getRotateAngle()接口去除；
2）boolean isNaviState()接口去除；
3）setRotateAngle(float)接口去除；

10、MarkerOptions

1）float getRotateAngle()接口去除；
2）rotateAngle(float)接口去除；
3）is3D()接口改为isFlat()；
4）is3D(boolean)接口改为flat(boolean)；

11、NetUtil类去掉
12、Polygon

1）isGeodesic()接口和setGeodesic(boolean)接口去除；

13、PolygonOptions

1）isGeodesic()接口和setGeodesic(boolean)接口去除；

14、Polyline

1）isGeodesic()接口和setGeodesic(boolean)接口去除；
2）setDottedLineTexture(java.lang.String)接口去除；

15、PolylineOptions

1）isGeodesic()接口和setGeodesic(boolean)接口去除；

新增

1、TencentMap

1）新增接口void setMyLocationStyle(MyLocationStyle)；

2、Polyline

1）增加接口void setColorTexture(String strTextureName, int rowCount)；
2）增加接口void setLineCap(boolean)/boolean getLineCap()；
3）增加接口 void insertPoint(int index, LatLng point)；

3、Polygon

1）新增接口boolean contains(LatLng point)；

4、Circle

1）新增接口boolean contains(LatLng latLng)；

5、Marker

1）新增接口void setFixingPoint(int x, int y)，void setFixingPointEnable(boolean)；

6、UiSettings

1）新增接口 void setFlingGestureEnabled(boolean)；
2）新增接口 void setLogoPosition(int)；
3）新增接口void setZoomPosition(int)；
4）新增接口setLogoPositionWithMargin(int,int,int,int,int)；
5）新增接口void setScaleViewPosition(int)；
6）新增接口void setScaleViewPositionWithMargin(int,int,int,int,int)；
7）新增接口void setCompassExtraPadding(int)；

2016-12-19 TencentMapSDK_3D_v3.0.6

修改

1.修复bug；

新增

1.增加崩溃上报机制，要开启这一功能需用户在 manifest 文件中添加 android.permission.READ_LOGS 权限，以帮助我们更好地提高地图稳定性;
2.全面升级为 HTTPS 服务;

2016-10-24 TencentMapSDK_3D_v3.0.5

修改

1.修复部分机型BitmapUtil报参数异常；
2.修复 Polyline 点集设置空时，点击事件报空指针；
3.修复部分机型 so 加载失败问题，提高兼容性；
4.修复绘制 ScaleMarker 时部分机型报参数异常；
5.修复 marker 的 TranslateAnimation 不生效问题；
6.修复 animateCamera 和 moveCamera 调用 rotateTo 及 zoomBy 的效果不一致问题；
7.修复 polyline zindex 值不生效问题；
8.修复 marker.isInfoWindowShown 始终返回 true；

2016-09-19 TencentMapSDK_3D_v3.0.4

修改

1.修复部分机型底图白斑问题；
2.修复截图功能逻辑，地图完全加载后再进行截图操作；
3.修复hideInfoWindow在 marker 点击时无效的问题；

新增

1.支持虚线及虚线样式设置；

2016-05-10 TencentMapSDK_3D_v3.0.3

修改

1.使用新版引擎；
2.修复Android 6.0 兼容问题；

2016-03-16 TencentMapSDK_3D_v3.0.16645

修改

部分地区不能正常显示问题；

2015-12-31 TencentMapSDK_3D_v3.0.16456

发布

1.支持地图显示、视角旋转；
2.支持3D楼块显示；
3.支持添加marker；
4.支持图形绘制；
5.支持实时交通；
6.支持热力图；