Mapbox Android学习笔记(6)相机的使用

2024-03-26 11:48

本文主要是介绍Mapbox Android学习笔记(6)相机的使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Camera

Maps SDK的地图使用Mercator投影表示为平面。在东西轴线上,这张地图无缝地绕了无数次。由于地形图的底部和顶部可能无限地变大,并进一步扭曲地形图的两极,南北轴线在北纬90度和南纬90度左右被切断。考虑到这一点,引入相机对象来表示用户在地图上方的视角。

默认情况下,相机可以由用户或开发人员倾斜、旋转、缩放和/或移动。重要的是要知道,在不直接影响此行为的情况下,相机对象不会对您添加的标记、层的源或其他注释进行任何更改。

Maps SDK中提供了一些相机事件监听器,用于通知相机何时调整。您可以在Events文档中阅读关于这些侦听器的更多信息。

1. 相机位置

Maps SDK包含一个CameraPosition类,它由摄像机的目标、角度、缩放和倾斜组成。这些api形成了用户对地图块的透视图。

一个camera aposition对象可以改变相机对象的一个属性,比如缩放,或者它可以同时改变多个属性。例如,您可以编写代码让摄像机同时更改目标、缩小和倾斜:

CameraPosition position = new CameraPosition.Builder().target(new LatLng(51.50550, -0.07520)).zoom(10).tilt(20).build();

注:您应该使用XML或通过MapboxMapOptions设置初始相机位置,以防止不必要的地图块下载,从而耗尽用户的数据。

目标

目标是一个单一的经纬度坐标,相机以它为中心。改变相机的目标会将相机移动到输入的坐标。目标是一个LatLng对象。目标坐标始终位于视图的中心。

倾斜

倾斜是相机从最低点(直接面对地球)的角度,使用单位角度。相机的最小(默认)倾斜度为0度,最大倾斜度为60度。倾斜水平使用六个小数点精度,这使您能够限制/设置/锁定地图的极端精度的轴承。

地图相机的倾斜也可以通过将两个手指放在地图上并同时上下移动手指来调整。

方位

方位是相机指向的方向,从北顺时针角度测量。

相机的默认方位为0度(即正北方向),导致地图罗盘隐藏,直到相机方位变为非零值。mapbox_uiCompass的布尔XML属性 允许调整罗盘的可见性。轴承等级使用6个小数点精度,这使您能够限制/设置/锁定地图的极端精度的轴承。除了可编程地调整相机的方位外,用户还可以将两个手指放在地图上并旋转手指。

缩放

缩放控制地图的比例,并使用0到22之间的任何值。在缩放级别0时,viewport显示大洲和其他世界特性。中间值11将显示城市级别的详细信息,在更高的缩放级别,地图将开始显示建筑物和感兴趣的点。相机可以通过以下方式放大:

  • 捏动两个手指来放大和缩小。
  • 用一根手指快速地在地图上点击两次来放大。
  • 用一根手指快速地在地图上点击两次,在第二次点击后将手指按在屏幕上。然后向上滑动手指缩小,向下缩小。

2. 更新相机位置

Maps SDK中的 MapboxMap 类有几个方法可以改变相机的位置。每个相机移动API都接受一个 CameraUpdate 对象。您应该使用 CameraUpdateFactory 类来提供新的摄像机位置信息。 CameraUpdateFactory 可以构建几个不同的 CameraUpdate 对象,包括 newLatLngZoom()、zoomBy()、newLatLngBounds() 以及其他一些对象。CameraUpdate 中一个简单的方法是 newCameraPosition(),这是传递构建的 CameraPosition 的方法。

mapboxMap.animateCamera(CameraUpdateFactory.newCameraPosition(position), millisecondSpeed);

除了使用相机更新对象外,还可以添加一个 cancelable 回调函数,以知道动画何时完成,或者用户是否通过在地图上执行手势取消了相机的移动。 ease 和 animate api 有一个可选的持续时间参数(以毫秒为单位),允许您控制摄像机的动画持续时间。API具体内容

3. 获得相机当前位置

MapboxMap类的 getCameraPosition() 方法帮助您的代码理解地图的相机发生了什么,以及用户正在查看什么。该方法返回一个 CameraPosition 对象,一旦有了该对象,就可以获取并使用相机的目标、倾斜、缩放和方位值。例如, mapboxMap.getCameraPosition ()。缩放是您获取相机当前缩放值的方式。

4. 将相机置于地图区域的中心

就像相机可以被限制在一个区域(见下),相机也可以在地图区域内居中。首先,您需要一个定义好的 LatLngBounds 对象,该对象至少包含两个坐标。然后,您将能够使用 可用的 newLatLngBounds() API 更新摄像机位置,该API将获取您的边界框并调整视图端口,使指定的区域位于视图中。除了将包围框传递到相机更新工厂之外,还需要提供一个整数值,定义屏幕边缘和实际有界区域之间的填充。您还可以选择为框的每一侧提供不同的填充值。示例如下:

LatLngBounds latLngBounds = new LatLngBounds.Builder().include(first marker position).include(second marker position).build();mapboxMap.animateCamera(CameraUpdateFactory.newLatLngBounds(latLngBounds, 10));

5. 将用户的平移限制在给定区域

MapboxMap类中的 setLatLngBoundsForCameraTarget 方法可以将地图相机限制在您想要的任何区域。如果向 LatLngBounds 对象提供至少两个 LatLng 对象/坐标,则会自动创建一个不可见的矩形,将摄像机限制在该区域内。

6. 相机和设备位置

如果您想了解更多关于相机控制及其在项目用户界面体验中的角色,请确保阅读Mapbox Location层组件提供的相机选项。(参照学习笔记(三)显示位置部分)

这篇关于Mapbox Android学习笔记(6)相机的使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/848404

相关文章

Python数据验证神器Pydantic库的使用和实践中的避坑指南

《Python数据验证神器Pydantic库的使用和实践中的避坑指南》Pydantic是一个用于数据验证和设置的库,可以显著简化API接口开发,文章通过一个实际案例,展示了Pydantic如何在生产环... 目录1️⃣ 崩溃时刻:当你的API接口又双叒崩了!2️⃣ 神兵天降:3行代码解决验证难题3️⃣ 深度

Linux内核定时器使用及说明

《Linux内核定时器使用及说明》文章详细介绍了Linux内核定时器的特性、核心数据结构、时间相关转换函数以及操作API,通过示例展示了如何编写和使用定时器,包括按键消抖的应用... 目录1.linux内核定时器特征2.Linux内核定时器核心数据结构3.Linux内核时间相关转换函数4.Linux内核定时

python中的flask_sqlalchemy的使用及示例详解

《python中的flask_sqlalchemy的使用及示例详解》文章主要介绍了在使用SQLAlchemy创建模型实例时,通过元类动态创建实例的方式,并说明了如何在实例化时执行__init__方法,... 目录@orm.reconstructorSQLAlchemy的回滚关联其他模型数据库基本操作将数据添

Spring配置扩展之JavaConfig的使用小结

《Spring配置扩展之JavaConfig的使用小结》JavaConfig是Spring框架中基于纯Java代码的配置方式,用于替代传统的XML配置,通过注解(如@Bean)定义Spring容器的组... 目录JavaConfig 的概念什么是JavaConfig?为什么使用 JavaConfig?Jav

Java使用Spire.Doc for Java实现Word自动化插入图片

《Java使用Spire.DocforJava实现Word自动化插入图片》在日常工作中,Word文档是不可或缺的工具,而图片作为信息传达的重要载体,其在文档中的插入与布局显得尤为关键,下面我们就来... 目录1. Spire.Doc for Java库介绍与安装2. 使用特定的环绕方式插入图片3. 在指定位

Springboot3 ResponseEntity 完全使用案例

《Springboot3ResponseEntity完全使用案例》ResponseEntity是SpringBoot中控制HTTP响应的核心工具——它能让你精准定义响应状态码、响应头、响应体,相比... 目录Spring Boot 3 ResponseEntity 完全使用教程前置准备1. 项目基础依赖(M

Java使用Spire.Barcode for Java实现条形码生成与识别

《Java使用Spire.BarcodeforJava实现条形码生成与识别》在现代商业和技术领域,条形码无处不在,本教程将引导您深入了解如何在您的Java项目中利用Spire.Barcodefor... 目录1. Spire.Barcode for Java 简介与环境配置2. 使用 Spire.Barco

Android使用java实现网络连通性检查详解

《Android使用java实现网络连通性检查详解》这篇文章主要为大家详细介绍了Android使用java实现网络连通性检查的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录NetCheck.Java(可直接拷贝)使用示例(Activity/Fragment 内)权限要求

C# 预处理指令(# 指令)的具体使用

《C#预处理指令(#指令)的具体使用》本文主要介绍了C#预处理指令(#指令)的具体使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学... 目录1、预处理指令的本质2、条件编译指令2.1 #define 和 #undef2.2 #if, #el

C#中Trace.Assert的使用小结

《C#中Trace.Assert的使用小结》Trace.Assert是.NET中的运行时断言检查工具,用于验证代码中的关键条件,下面就来详细的介绍一下Trace.Assert的使用,具有一定的参考价值... 目录1、 什么是 Trace.Assert?1.1 最简单的比喻1.2 基本语法2、⚡ 工作原理3