对象:setRegion()

类型 函数
对象 地图
库 native.*
返回值 无
修订 版本 2024.3703
关键词 setRegion
另请参阅 对象:setCenter()

概述

将显示的地图区域移动到新的位置，新的中心点和水平/垂直跨度距离以纬度和经度表示。这将隐式设置缩放级别。此函数将对跨度设置进行“合理性检查”，即使 `latitudeSpan` 和 `longitudeSpan` 指定的值截然不同，也会插值出一致的缩放级别。最后一个参数是一个可选的布尔值（默认为 `false`），用于确定过渡是动画的还是立即发生的。

请注意，纬度和经度涵盖地球上的大片区域，因此即使是很小的变化也会转化为地图上的巨大位置变化，尤其是在近距离缩放级别。另请注意，地球上大多数地图位置都相当空旷，因此在试验地图时，使用已知的纬度/经度值通常会更容易。如果您需要一个快速测试位置，请尝试在像 谷歌地图 这样的网站上查找您自己的地址。

语法

object:setRegion( latitude, longitude, latitudeSpan, longitudeSpan [, isAnimated] )
纬度 (必填)

数字. 区域中心点的纬度。

经度 (必填)

数字. 区域中心点的经度。

纬度跨度 (必填)

数字. 区域的纬度跨度（以度为单位）。这将隐式设置地图的缩放级别。

经度跨度 (必填)

数字. 区域的经度跨度（以度为单位）。这将隐式设置地图的缩放级别。

是否动画 (可选)

布尔值. 指定是否将地图从当前区域动画到新区域。默认为 `false`。

示例

local myMap = native.newMapView( 0, 0, display.contentWidth, display.contentHeight )
myMap:setRegion( 37.331692, -122.030456, 0.01, 0.01, false )