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

相关文章

C++使用栈实现括号匹配的代码详解

《C++使用栈实现括号匹配的代码详解》在编程中,括号匹配是一个常见问题,尤其是在处理数学表达式、编译器解析等任务时,栈是一种非常适合处理此类问题的数据结构,能够精确地管理括号的匹配问题,本文将通过C+... 目录引言问题描述代码讲解代码解析栈的状态表示测试总结引言在编程中,括号匹配是一个常见问题,尤其是在

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下:1. 字符串的不可变性:每次修改都创建新对象2. 使用 == 比较字符串,陷阱满

Python使用国内镜像加速pip安装的方法讲解

《Python使用国内镜像加速pip安装的方法讲解》在Python开发中,pip是一个非常重要的工具,用于安装和管理Python的第三方库,然而,在国内使用pip安装依赖时,往往会因为网络问题而导致速... 目录一、pip 工具简介1. 什么是 pip?2. 什么是 -i 参数?二、国内镜像源的选择三、如何

使用C++实现链表元素的反转

《使用C++实现链表元素的反转》反转链表是链表操作中一个经典的问题,也是面试中常见的考题,本文将从思路到实现一步步地讲解如何实现链表的反转,帮助初学者理解这一操作,我们将使用C++代码演示具体实现,同... 目录问题定义思路分析代码实现带头节点的链表代码讲解其他实现方式时间和空间复杂度分析总结问题定义给定

Linux使用nload监控网络流量的方法

《Linux使用nload监控网络流量的方法》Linux中的nload命令是一个用于实时监控网络流量的工具,它提供了传入和传出流量的可视化表示,帮助用户一目了然地了解网络活动,本文给大家介绍了Linu... 目录简介安装示例用法基础用法指定网络接口限制显示特定流量类型指定刷新率设置流量速率的显示单位监控多个

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》:本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2

python使用fastapi实现多语言国际化的操作指南

《python使用fastapi实现多语言国际化的操作指南》本文介绍了使用Python和FastAPI实现多语言国际化的操作指南,包括多语言架构技术栈、翻译管理、前端本地化、语言切换机制以及常见陷阱和... 目录多语言国际化实现指南项目多语言架构技术栈目录结构翻译工作流1. 翻译数据存储2. 翻译生成脚本

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后

C++ Primer 多维数组的使用

《C++Primer多维数组的使用》本文主要介绍了多维数组在C++语言中的定义、初始化、下标引用以及使用范围for语句处理多维数组的方法,具有一定的参考价值,感兴趣的可以了解一下... 目录多维数组多维数组的初始化多维数组的下标引用使用范围for语句处理多维数组指针和多维数组多维数组严格来说,C++语言没