高德定位 GaodeLocation

使用高德定位技术,快速获得设备位置信息。支持“组合”(会同时使用网络定位和GPS定位,优先返回最高精度的定位结果,以及对应的地址描述信息。)、网络(不会使用GPS和其他传感器,只会使用WiFi和基站定位,比较省电,)、GPS(不需要连接网络,这种模式下不支持室内环境的定位,需要在室外环境下才可以成功定位。) 获取 API KEY

属性

  • 精度 Accuracy 数字 只代码, 只读 暂无描述
  • 海拔 Altitude 数字 只代码, 只读 暂无描述
  • API密钥 ApiKey 文本 只写 高德位置服务的API Key。
  • 当前地址 CurrentAddress 文本 只代码, 只读 使用高精度或网络定位时,获取位置的地址信息
  • 定位间距 DistanceInterval 数字 暂无描述
  • 是否启用 Enabled 布尔 暂无描述
  • 是否有精度数据 HasAccuracy 布尔 只代码, 只读 暂无描述
  • 是否有海拔数据 HasAltitude 布尔 只代码, 只读 暂无描述
  • 是否有方向角数据 HasBearing 布尔 只代码, 只读 暂无描述
  • 是否有经纬度数据 HasLongitudeLatitude 布尔 只代码, 只读 暂无描述
  • 是否有速度数据 HasSpeed 布尔 只代码, 只读 暂无描述
  • 纬度 Latitude 数字 只代码, 只读 暂无描述
  • 定位模式 LocationMode 数字 暂无描述
  • 经度 Longitude 数字 只代码, 只读 暂无描述
  • 时间间隔 TimeInterval 数字 暂无描述

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 位置被更改 LocationChanged 纬度 latitude: 数字, 经度 longitude: 数字, 海拔 altitude: 数字, 速度 speed: 数字 暂无描述

方法

  • 获取地址字段 GetAddressField 文本 字段序号 addressFieldIndex: 数字 1:国家,2:省份;3:城市;4:城区;5:街道;6:街道门牌号; 7:室内定位建筑物编号;8:室内定位楼层;9:城市编码;10:城区编码;11:兴趣点名称;12:兴趣区名称
  • 定位类型 LocationType 数字 -1:未定位;0:定位失败;1:GPS定位结果;2:前次定位结果; 4:缓存定位结果;5:Wifi定位结果;6:基站定位结果;7:离线定位结果

高德地图 Map

一个二维容器,在背景中渲染地图图块,并允许多个Marker元素识别地图上的点。地图图块由OpenStreetMap贡献者和美国地质调查局提供,也可以提供自定义底图URL。

属性

  • 边界列表 BoundingBox 列表 只代码 地图的边界框以[[北, 西], [南, 东]]的格式存储。
  • 中心坐标 CenterFromString 文本 只写 设置地图的初始中心坐标。该值指定为逗号分隔的十进制纬度和经度坐标对,例如42.359144、-71.093612。在块代码中,出于性能原因,建议使用具有数字纬度和经度的PanTo,而不是转换为字符串表示形式以用于此属性。
  • 是否允许移动 EnablePan 布尔 启用地图的双指平移功能
  • 是否允许旋转 EnableRotation 布尔 如果设置为true,用户可以使用多点触控手势以当前中心点为中心旋转地图。
  • 是否允许缩放 EnableZoom 布尔 如果此属性设置为true,则地图上允许多点触控缩放手势。否则,用户只能通过缩放控制按钮更改地图缩放。
  • 物体列表 Features 列表 只代码, 只读 获取地图上附加的功能列表(不考虑功能的“Visible”属性的值)。此列表还包括通过调用“FeatureFromDescription”在地图上创建的任何功能。
  • 高度 Height 数字 只代码 指定地图的垂直高度,以像素为单位。
  • 百分比高 HeightPercent 数字 只代码, 只写 指定 Map’s 垂直 高度 为 百分比 的 屏幕’s 高度.
  • 纬度 Latitude 数字 只代码, 只读 地图中心的纬度。
  • 位置传感器 LocationSensor 组件 只写 将提供的LocationSensor用于用户位置数据,而不是内置的位置提供程序。
  • 经度 Longitude 数字 只代码, 只读 获取地图中心的经度。要更改经度,请使用PanTo方法。
  • 地图类型 MapType 数字 用作地图底层的图块层类型。有效值包括:1(道路)、2(航空)、3(地形)
  • 是否原点在中心 OriginAtCenter 布尔 只代码 暂无描述
  • 旋转 Rotation 数字 指定 旋转 的 map dec我mal 度, 如果 任何.
  • 旋转角度 RotationAngle 数字 只代码 暂无描述
  • 比例尺单位 ScaleUnits 数字 指定用于比例尺覆盖的单位。选择1(默认值)将使用公制单位(公里、米),而选择2将使用英制单位(英里、英尺)。
  • 是否显示指南针 ShowCompass 布尔 指定是否在地图上叠加指南针。如果硬件中存在数字指南针,则指南针将根据设备的方向进行旋转。
  • 是否显示比例尺 ShowScale 布尔 在地图上显示比例尺参考。
  • 是否显示用户坐标 ShowUser 布尔 在地图上显示用户的位置。
  • 是否显示缩放控制 ShowZoom 布尔 指定是否显示缩放控件。
  • 用户纬度 UserLatitude 数字 只代码, 只读 返回 用户’s l在ude 如果 显示用户 是启用.
  • 用户经度 UserLongitude 数字 只代码, 只读 如果启用了ShowUser,则返回用户的经度。
  • 不透明度 ViewAlpha 数字 只代码 暂无描述
  • 显示顺序 ViewIndex 数字 只代码 在设置属性时,容器内组件的顺序为:1表示第一个,0表示最后一个
  • 模板类型 ViewType 数字 暂无描述
  • 是否显示 Visible 布尔 指定地图是否应在屏幕上可见。如果显示Map,则值为true;如果隐藏Map,则为false。
  • 宽度 Width 数字 只代码 指定地图的水平宽度,以像素为单位。
  • 百分比宽 WidthPercent 数字 只代码, 只写 指定 水平 宽度 的 Map 为 百分比 的 屏幕’s 宽度.
  • X坐标 XCoord 数字 只代码, 只读 暂无描述
  • Y坐标 YCoord 数字 只代码, 只读 暂无描述
  • Z坐标 ZCoord 数字 只代码 暂无描述
  • 缩放级别 ZoomLevel 数字 指定地图的缩放级别。ZoomLevel的有效值取决于图块提供程序以及地图的纬度和经度。例如,与密集的城市中心相比,海洋上的缩放级别受到更多限制,以节省存储瓷砖的空间,因此海洋上的有效值可能为1-7,城市上的有效值为1-20。如果缩放级别太大,服务器无法支持,磁贴提供商可能会发送警告或错误磁贴。

事件

  • 点击物体集合 FeatureClick 地图物体 feature: 组件 单击要素时,父地图也将收到FeatureClick事件。特征参数指示单击了哪个子特征。此事件在相应功能上的Click事件之后运行,并在任何时候运行。..如果提供了事件,请单击事件。
  • 长按物体集合 FeatureLongClick 地图物体 feature: 组件 当一个要素被长时间单击时,父地图也会收到一个FeatureLongClick事件。特征参数指示哪个子特征被长时间单击。此事件在相应功能上的LongClick事件之后运行,并在任何时候运行。..LongClick事件(如果提供)。
  • 开始拖动物体集合 FeatureStartDrag 地图物体 feature: 组件 当用户开始拖动要素时,父地图也将收到FeatureStartDrag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的StartDrag事件之后运行,并在任何时候运行。..StartDrag事件(如果提供)。
  • 拖动物体集合 FeatureDrag 地图物体 feature: 组件 当用户拖动要素时,父地图也将收到FeatureDrag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的拖动事件之后以及任何时候运行。..拖动事件(如果提供)。
  • 拖动物体集合结束 FeatureStopDrag 地图物体 feature: 组件 当用户停止拖动要素时,父地图也将收到FeatureStop Drag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的StopDrag事件之后运行,并在任何时候运行。..如果提供了StopDrag事件,则显示该事件。
  • 获取物体集合完成 GotFeatures 网址 url: 文本, 物体列表 features: 列表 当从给定URL成功读取功能集合时,将运行GotFeatures事件。features参数将是一个功能描述列表,这些描述可以使用FeatureFromDescription方法转换为组件。
  • 加载出错 LoadError 网址 url: 文本, 响应代码 responseCode: 数字, 错误信息 errorMessage: 文本 当在给定URL处理功能集合文档时发生错误时,将触发LoadError事件。responseCode参数将包含一个HTTP状态码,而errorMessage参数将包含详细的错误消息。
  • 地图加载完成 Ready 一旦Map初始化并准备好进行用户交互,Ready事件就会运行。
  • 显示区域改变 BoundsChange 当用户通过缩放、平移或旋转视图来更改地图边界时,BoundsChange事件会运行。
  • 缩放级别改变 ZoomChange 用户已更改了地图的缩放级别。
  • 坐标点无效 InvalidPoint 消息 message: 文本 在执行地图操作时,提供了一个无效的坐标。消息参数将包含有关此问题的更多详细信息。
  • 被点击 TapAtPoint 纬度 latitude: 数字, 经度 longitude: 数字 当用户点击地图上的某个点时,TapAtPoint会运行。点击的位置将通过纬度和经度参数在地图坐标中报告。
  • 点击指南针 TapAtCompass 纬度 latitude: 数字, 经度 longitude: 数字 点击指南针
  • 点击用户坐标 TapAtUser 纬度 latitude: 数字, 经度 longitude: 数字 点击用户坐标
  • 被双击 DoubleTapAtPoint 纬度 latitude: 数字, 经度 longitude: 数字 当用户在地图上的某个点双击时,DoubleTapAtPoint就会运行。点击的位置将通过纬度和经度参数在地图坐标中报告。
  • 被长按 LongPressAtPoint 纬度 latitude: 数字, 经度 longitude: 数字 当用户长按地图上的某个点而不移动手指(这会触发拖动)时,LongPressAt点会运行。长压机的位置将通过纬度和经度参数在地图坐标中报告。

方法

  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 暂无描述
  • 移动到 MoveToContainer 容器 container: 布局 暂无描述
  • 设置位置 SetPosition X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 从网址加载 LoadFromURL 网址 url: 文本 从给定URL加载GeoJSON格式的要素集合。若成功,将引发GotFeatures事件,并附带给定URL以及从GeoJSON解析出的要素列表,该列表以(键, 值)对的形式呈现。若失败,将引发LoadError事件,并附带任何适用的HTTP响应码和错误消息。
  • 从描述加载 FeatureFromDescription 任意 描述 description: 列表 将功能描述转换为App Inventor地图功能。目前仅此一项
  • 创建圆形 CreateCircle 组件 创建"圆形"组件
  • 创建线条 CreateLineString 组件 创建"线条"组件
  • 创建标记 CreateMarker 组件 纬度 latitude: 数字, 经度 longitude: 数字 在地图上指定的纬度和经度处创建新的标记。
  • 创建多边形 CreatePolygon 组件 创建"多边形"组件
  • 创建矩形 CreateRectangle 组件 创建"矩形"组件
  • 创建物体集合 CreateFeatureCollection 组件 创建"物体集合"组件
  • 显示到 PanTo 纬度 latitude: 数字, 经度 longitude: 数字, 缩放 zoom: 数字 将地图中心平移到给定的纬度和经度,并将缩放级别调整到指定的缩放。
  • 保存 Save 路径 path: 文本 将地图上的要素以GeoJSON文件格式保存在指定路径中。
  • 转为屏幕坐标列表 LocationToXYList 列表 纬度 latitude: 数字, 经度 longitude: 数字 将纬度经度坐标,转为地图相对于父容器左上角的XY坐标。
  • 转为地理坐标列表 XYListToLocation 列表 X坐标 x: 数字, Y坐标 y: 数字 将地图相对于父容器左上角的XY坐标,转为地图中的纬度经度坐标。

标记 Marker

标记组件指示地图上的点,如建筑物或其他兴趣点。标记可以通过多种方式进行自定义,例如使用应用程序资源中的自定义图像或更改标记填充颜色。还可以通过调用Map的CreateMarker方法动态创建标记,并使用“Any Component”块进行配置。

属性

  • 对齐方式 AnchorAlignment 数字 暂无描述
  • 描述 Description 文本 用户点击标记时,信息窗口中显示的描述。
  • 是否可移动 Draggable 布尔 “draggable”属性用于设置用户是否可以通过长按标记,然后将标记拖动到新位置来拖动标记。
  • 是否启用信息框 EnableInfobox 布尔 当用户点击标记时,启用或禁用信息框窗口的显示。
  • 填充颜色 FillColor 颜色 用于填充标记的涂料颜色。
  • 填充不透明度 FillOpacity 数字 地图特征内部的不透明度。
  • 高度 Height 数字 只代码 指定标记的垂直高度,以像素为单位。
  • 百分比高 HeightPercent 数字 只代码, 只写 指定 Marker’s 垂直 高度 为 百分比 的 屏幕’s 高度.
  • 标记图片 ImageAsset 文本 指定标记显示的图像。如果设置为空字符串“”,则将使用默认标记图标。
  • 纬度 Latitude 数字 设置或获取标记的纬度,单位为度,正值表示赤道以北,负值表示赤道以南。要同时更新纬度和经度,请使用SetLocation方法。
  • 经度 Longitude 数字 设置或获取标记的经度,单位为度,正值表示本初子午线以东,负值表示本初经线以西。要同时更新纬度和经度,请使用SetLocation方法。
  • 线条颜色 StrokeColor 颜色 用于勾勒标记轮廓的油漆颜色。
  • 线条不透明度 StrokeOpacity 数字 用于勾勒地图要素轮廓的笔触的不透明度。
  • 线条宽度 StrokeWidth 数字 用于勾勒标记轮廓的笔画的宽度。
  • 标题 Title 文本 用户点击标记时,信息窗口中显示的标题。
  • 类型 Type 文本 只代码, 只读 返回地图功能的类型。对于标记(Marker)而言,此函数将返回文本“Marker”。
  • 是否显示 Visible 布尔 指定标记是否应在屏幕上可见。如果标记正在显示,则值为true,如果隐藏,则为false。
  • 宽度 Width 数字 只代码 指定标记的水平宽度,以像素为单位。
  • 百分比宽 WidthPercent 数字 只代码, 只写 指定 水平 宽度 的 Marker 为 百分比 的 屏幕’s 宽度.

事件

  • 被点击 Click 当用户点击标记时,Click事件会运行。
  • 被长按 LongClick 当用户按住标记并释放它时,LongClick事件会运行。只有当Draggable为false时,此事件才会触发,因为它使用与StartDrag相同的手势。
  • 开始移动 StartDrag 当用户按住标记,然后在屏幕上移动手指时,StartDrag事件就会运行。随后将出现Drag和StopDrag事件。
  • 正在移动 Drag 用户拖动了标记。
  • 移动结束 StopDrag 用户停止了拖动操作。

方法

  • 显示信息框 ShowInfobox 如果标记不可见,则显示标记的信息框。否则,此方法无效。即使EnableInfobox为false,此方法也可用于显示信息框。
  • 隐藏信息框 HideInfobox 如果信息框已显示,则将其隐藏。如果信息框未显示,则此函数无效。
  • 到物体的距离 DistanceToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 计算两个地图要素之间的距离(单位:米)。
  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 从地图中删除该对象。
  • 设置坐标 SetLocation 纬度 latitude: 数字, 经度 longitude: 数字 设置 位置 的 Marker.
  • 到坐标点的距离 DistanceToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字 计算标记与经纬度点之间的距离,单位为米。
  • 与坐标点的夹角 BearingToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字 将标记的方位返回到给定的纬度和经度,以正北度为单位。
  • 与物体的夹角 BearingToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 返回从标记到给定地图要素的方位,以正北度为单位。如果质心参数为真,则方位将指向地图特征的中心。否则,方位将计算到特征中最靠近标记的点。

线条 LineString

LineString是一个用于在地图上绘制开放、连续线条序列的组件。要在设计器中向LineString添加新点,请将任何线段的中点拖离该线以引入新顶点。通过单击顶点并将其拖动到新位置来移动顶点。单击顶点将删除该顶点,除非只剩下两个。

属性

  • 描述 Description 文本 当用户点击LineString时,信息窗口中显示的描述。
  • 是否可移动 Draggable 布尔 “draggable”属性用于设置用户是否可以通过长按并将线串(LineString)拖动到新位置来拖动该线串。
  • 是否启用信息框 EnableInfobox 布尔 当用户点击LineString时,启用或禁用信息框窗口显示。
  • 坐标点列表 Points 列表 只代码 LineString中的点列表,作为纬度和经度对。
  • 坐标点列表的字符串 PointsFromString 文本 只写 从以下格式的特殊编码字符串中设置LineString的点:[[纬度1,经度1],[纬度2,经度2],…]
  • 线条颜色 StrokeColor 颜色 用于勾勒线串轮廓的油漆颜色。
  • 线条不透明度 StrokeOpacity 数字 用于勾勒地图要素轮廓的笔触的不透明度。
  • 线条宽度 StrokeWidth 数字 用于勾勒出LineString轮廓的笔画的宽度。
  • 标题 Title 文本 当用户点击 LineString 时,信息窗口中显示的标题。
  • 类型 Type 文本 只代码, 只读 返回地图要素的类型。对于LineString,这将返回MapFeature。LineString(“LineString”)。
  • 是否显示 Visible 布尔 指定LineString是否应在屏幕上可见。如果显示LineString,则值为true;如果隐藏LineString,值为false。

事件

  • 被点击 Click 当用户点击LineString时,Click事件会运行。
  • 被长按 LongClick 当用户按住LineString然后释放它时,LongClick事件会运行。只有当Draggable为false时,此事件才会触发,因为它使用与StartDrag相同的手势。
  • 开始移动 StartDrag 当用户按住LineString,然后在屏幕上移动手指时,StartDrag事件会运行。随后将出现Drag和StopDrag事件。
  • 正在移动 Drag 当用户拖动LineString时,Drag事件会响应LineString的位置更新而运行。
  • 移动结束 StopDrag 当用户在拖动结束时释放LineString时,StopDrag事件会运行。

方法

  • 显示信息框 ShowInfobox 如果LineString不可见,则显示其信息框。否则,此方法无效。即使EnableInfobox为false,此方法也可用于显示信息框。
  • 隐藏信息框 HideInfobox 隐藏LineString的信息框(如果可见)。否则,不会采取任何行动。
  • 到坐标点的距离 DistanceToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字, 是否使用重心 centroid: 布尔 计算LineString与给定纬度和经度之间的距离。如果质心为真,则计算从LineString的中心到给定点的距离。否则,将计算从LineString上最近的点到给定点的距离。此外,如果质心为假并且点在LineString中,则此方法将返回0。如果发生错误,将返回-1。
  • 到物体的距离 DistanceToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 计算两个地图特征之间的距离(单位:米)。
  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 从地图中删除该对象。

圆形 Circle

“圆”组件将以纬度和经度为中心的给定半径(单位为米)的圆可视化。可以使用FillColor、StrokeColor和StrokeWidth等属性自定义圆的外观。

属性

  • 描述 Description 文本 当用户点击圆圈时,信息窗口中显示的描述。
  • 是否可移动 Draggable 布尔 “draggable”属性用于设置用户是否可以通过长按然后将圆圈拖动到新位置来拖动圆圈。
  • 是否启用信息框 EnableInfobox 布尔 当用户点击圆圈时,启用或禁用信息框窗口的显示。
  • 填充颜色 FillColor 颜色 用于填充圆圈的油漆颜色。
  • 填充不透明度 FillOpacity 数字 地图特征内部的不透明度。
  • 纬度 Latitude 数字 圆心所在的纬度。
  • 经度 Longitude 数字 圆心的经度。
  • 半径 Radius 数字 圆的半径,单位为米。
  • 线条颜色 StrokeColor 颜色 用于勾勒圆圈轮廓的油漆颜色。
  • 线条不透明度 StrokeOpacity 数字 用于勾勒地图要素轮廓的笔触的不透明度。
  • 线条宽度 StrokeWidth 数字 用于勾勒圆圈轮廓的笔画的宽度。
  • 标题 Title 文本 当用户点击圆圈时,信息窗口中显示的标题。
  • 类型 Type 文本 只代码, 只读 返回要素的类型。对于圆,将返回MapFeature.Circle(“圆”)。
  • 是否显示 Visible 布尔 指定圆圈是否应在屏幕上可见。如果圆圈显示,则值为true;如果隐藏,则值为false。

事件

  • 被点击 Click 当用户点击圆圈时,Click事件会运行。
  • 被长按 LongClick 当用户按住圆圈并随后释放时,会触发LongClick事件。此事件仅在draggable为false时触发,因为它与StartDrag使用相同的手势。
  • 开始移动 StartDrag 当用户按住圆圈并继续在屏幕上移动手指时,StartDrag(开始拖动)事件将会触发。随后,Drag(拖动)事件和StopDrag(停止拖动)事件也会相继发生。
  • 正在移动 Drag 用户拖动了圆圈。
  • 移动结束 StopDrag 用户停止了拖动操作。

方法

  • 显示信息框 ShowInfobox 如果信息框未显示,则显示该圈的信息框。否则,此方法无效。即使EnableInfobox为false,此方法也可用于显示信息框。
  • 隐藏信息框 HideInfobox 如果信息框已显示,则将其隐藏。如果信息框未显示,则此函数无效。
  • 到坐标点的距离 DistanceToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字, 是否使用重心 centroid: 布尔 计算圆与给定纬度和经度之间的距离。如果centroids为true,则计算从圆心到给定点的距离。否则,计算从圆上最接近给定点的点到给定点的距离。此外,如果centroids为false且给定点在圆内,则此方法将返回0。如果发生错误,将返回-1。
  • 到物体的距离 DistanceToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 计算两个地图要素之间的距离(单位:米)。
  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 从地图中删除该对象。
  • 设置坐标 SetLocation 纬度 latitude: 数字, 经度 longitude: 数字 将圆形的中心移动到给定的纬度和经度。此方法比分别设置纬度和经度更高效。

矩形 Rectangle

直角是北、南、东、西边界具有固定纬度和经度的多边形。移动矩形的顶点会相应地更新相应的边。

属性

  • 描述 Description 文本 当用户点击矩形时,信息窗口中显示的描述。
  • 是否可移动 Draggable 布尔 “draggable”属性用于设置用户是否可以通过长按矩形并将其拖动到新位置来拖动矩形。
  • 东经度 EastLongitude 数字 指定矩形最东边的边,以本初子午线以东的小数点为单位。
  • 是否启用信息框 EnableInfobox 布尔 当用户点击矩形时,启用或禁用信息框窗口的显示。
  • 填充颜色 FillColor 颜色 用于填充矩形的油漆颜色。
  • 填充不透明度 FillOpacity 数字 地图特征内部的不透明度。
  • 北纬度 NorthLatitude 数字 指定矩形的最北边缘,以赤道以北的十进制度数表示。
  • 南纬度 SouthLatitude 数字 指定矩形的最西端,位于本初子午线以东的小数点。
  • 线条颜色 StrokeColor 颜色 用于勾勒矩形轮廓的涂料颜色。
  • 线条不透明度 StrokeOpacity 数字 用于勾勒地图要素轮廓的笔触的不透明度。
  • 线条宽度 StrokeWidth 数字 用于勾勒矩形轮廓的笔画的宽度。
  • 标题 Title 文本 当用户点击矩形时,信息窗口中显示的标题。
  • 类型 Type 文本 只代码, 只读 特征的类型。对于矩形,此函数将返回文本“Rectangle”。
  • 是否显示 Visible 布尔 指定矩形是否应在屏幕上可见。如果矩形显示,则值为true,如果隐藏,则为false。
  • 西经度 WestLongitude 数字 矩形的西边,赤道以东的十进制度数。

事件

  • 被点击 Click 当用户点击矩形时,Click事件会运行。
  • 被长按 LongClick 当用户按住矩形并释放它时,LongClick事件会运行。只有当Draggable为false时,此事件才会触发,因为它使用与StartDrag相同的手势。
  • 开始移动 StartDrag 当用户按住矩形,然后在屏幕上移动手指时,StartDrag事件就会运行。随后将出现Drag和StopDrag事件。
  • 正在移动 Drag 用户拖动了矩形。
  • 移动结束 StopDrag 用户停止了拖动操作。

方法

  • 显示信息框 ShowInfobox 如果矩形不可见,则显示矩形的信息框。否则,此方法无效。即使EnableInfobox为false,此方法也可用于显示信息框。
  • 隐藏信息框 HideInfobox 如果信息框已显示,则将其隐藏。如果信息框未显示,则此函数无效。
  • 到坐标点的距离 DistanceToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字, 是否使用重心 centroid: 布尔 计算矩形与给定纬度和经度之间的距离。如果质心为真,则计算从矩形中心到给定点的距离。否则,将计算从矩形上最近的点到给定点的距离。此外,如果质心为假并且点位于矩形中,则此方法将返回0。如果发生错误,将返回-1。
  • 到物体的距离 DistanceToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 计算两个地图特征之间的距离(单位:米)。
  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 从地图中删除该对象。
  • 中心列表 Center 列表 以列表形式返回矩形的中心(纬度-经度)。
  • 边界列表 Bounds 列表 以((西北)(东南))格式返回矩形的边界框。
  • 设置中心 SetCenter 纬度 latitude: 数字, 经度 longitude: 数字 将矩形移动到给定纬度和经度的中心,尝试保持宽度和高度(以米为单位)尽可能相等,以适应纬度的变化。

多边形 Polygon

多边形包围地图上的任意二维区域。多边形可用于绘制周界,如校园、城市或国家。多边形以基本三角形开始。通过将多边形的中点拖离边,可以创建新顶点。单击顶点将删除该顶点,但必须始终存在至少3个顶点。

属性

  • 描述 Description 文本 用户点击多边形时,信息窗口中显示的描述。
  • 是否可移动 Draggable 布尔 “draggable”属性用于设置用户是否可以通过长按多边形并将其拖动到新位置来拖动该多边形。
  • 是否启用信息框 EnableInfobox 布尔 当用户点击多边形时,启用或禁用信息框窗口的显示。
  • 填充颜色 FillColor 颜色 用于填充多边形的涂料颜色。
  • 填充不透明度 FillOpacity 数字 地图特征内部的不透明度。
  • 中空区域坐标点列表 HolePoints 列表 只代码 指定多边形中任何孔的点。HolePoints属性是一个列表列表,每个子列表包含(纬度、经度)点,表示一个孔。
  • 中空区域坐标点列表的字符串 HolePointsFromString 文本 只写 从GeoJSON字符串中指定多边形中的孔。与HolePoints不同,每个点的经度都在GeoJSON规范中规定的纬度之前。
  • 坐标点列表 Points 列表 只代码 指定用于绘制多边形的点。点被指定为包含纬度和经度值的列表,例如[[lat1,long1],[lat2,long2]。..].
  • 坐标点列表的字符串 PointsFromString 文本 只写 从GeoJSON字符串中指定多边形的点。与points不同,此属性要求经度在点中排在第一位,而不是纬度。
  • 线条颜色 StrokeColor 颜色 用于勾勒多边形的涂料颜色。
  • 线条不透明度 StrokeOpacity 数字 用于勾勒地图要素轮廓的笔触的不透明度。
  • 线条宽度 StrokeWidth 数字 用于勾勒多边形轮廓的笔画的宽度。
  • 标题 Title 文本 用户点击多边形时,信息窗口中显示的标题。
  • 类型 Type 文本 只代码, 只读 要素的类型。对于多边形,此函数将返回文本“Polygon”。
  • 是否显示 Visible 布尔 指定多边形是否应在屏幕上可见。如果显示多边形,则值为true;如果隐藏多边形,则为false。

事件

  • 被点击 Click 当用户点击多边形时,Click事件会触发。
  • 被长按 LongClick 当用户按住多边形并释放它时,LongClick事件会运行。只有当Draggable为false时,此事件才会触发,因为它使用与StartDrag相同的手势。
  • 开始移动 StartDrag 当用户按住多边形,然后在屏幕上移动手指时,StartDrag事件会运行。随后将出现Drag和StopDrag事件。
  • 正在移动 Drag 用户拖动了多边形。
  • 移动结束 StopDrag 用户停止了拖动操作。

方法

  • 显示信息框 ShowInfobox 如果多边形不可见,则显示其信息框。否则,此方法无效。即使EnableInfobox为false,此方法也可用于显示信息框。
  • 隐藏信息框 HideInfobox 如果信息框已显示,则将其隐藏。如果信息框未显示,则此函数无效。
  • 到坐标点的距离 DistanceToPoint 数字 纬度 latitude: 数字, 经度 longitude: 数字, 是否使用重心 centroid: 布尔 计算多边形与给定纬度和经度之间的距离。如果质心为真,则计算从多边形中心到给定点的距离。否则,将计算从多边形上最近的点到给定点的距离。此外,如果质心为假且点位于多边形中,则此方法将返回0。如果发生错误,将返回-1。
  • 到物体的距离 DistanceToFeature 数字 地图物体 mapFeature: 组件, 是否使用重心 centroids: 布尔 计算两个地图要素之间的距离(单位:米)。
  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 从地图中删除该对象。
  • 重心列表 Centroid 列表 获取多边形的质心作为(纬度、经度)对。

物体集合 FeatureCollection

FeatureCollection将一个或多个地图要素组合在一起。集合中某个特征上发生的任何事件也将触发集合组件中的相应事件。FeatureCollection可以从外部资源加载,以用内容填充地图。GeoJSON是目前唯一支持的格式。

属性

  • 物体列表 Features 列表 只代码, 只读 获取附加到FeatureCollection的功能列表(不考虑功能的Visible属性的值)。此列表还包括通过调用FeatureFromDescription在FeatureCollection上创建的任何功能。
  • GeoJSON描述物体 FeaturesFromGeoJSON 文本 只写 从给定字符串加载一组特征。如果字符串不是有效的GeoJSON 格式,则将运行 ErrorLoadingFeatureCollection 错误,并显示 url =
  • 源文件 Source 文本 只读 指定用于填充要素集合的源URL。如果要素集合不是从URL加载的,则此项将为空字符串。
  • 不透明度 ViewAlpha 数字 只代码 暂无描述
  • 显示顺序 ViewIndex 数字 只代码 在设置属性时,容器内组件的顺序,1表示第一个,0表示最后一个
  • 模板类型 ViewType 数字 暂无描述
  • 是否显示 Visible 布尔 指定FeatureCollection是否应在屏幕上可见。如果FeatureCollection正在显示,则值为true,如果隐藏,则为false。

事件

  • 点击物体集合 FeatureClick 地图物体 feature: 组件 单击功能时,父FeatureCollection也将收到FeatureClick事件。特征参数指示单击了哪个子特征。此事件在相应功能上的Click事件之后运行,并在任何时候运行。..如果提供了事件,请单击事件。
  • 长按物体集合 FeatureLongClick 地图物体 feature: 组件 当一个功能被长时间单击时,父FeatureCollection也会收到一个FeatureLongClick事件。特征参数指示哪个子特征被长时间单击。此事件在相应功能上的LongClick事件之后运行,并在任何时候运行。..LongClick事件(如果提供)。
  • 开始拖动物体集合 FeatureStartDrag 地图物体 feature: 组件 当用户开始拖动功能时,父FeatureCollection也将收到FeatureStartDrag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的StartDrag事件之后运行,并在任何时候运行。..StartDrag事件(如果提供)。
  • 拖动物体集合 FeatureDrag 地图物体 feature: 组件 当用户拖动功能时,父FeatureCollection也将收到FeatureDrag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的拖动事件之后以及任何时候运行。..拖动事件(如果提供)。
  • 拖动物体集合结束 FeatureStopDrag 地图物体 feature: 组件 当用户停止拖动功能时,父FeatureCollection也将收到FeatureTopDrag事件。特征参数指示拖动了哪个子特征。此事件在相应功能上的StopDrag事件之后运行,并在任何时候运行。..如果提供了StopDrag事件,则显示该事件。
  • 加载出错 LoadError 网址 url: 文本, 响应代码 responseCode: 数字, 错误信息 errorMessage: 文本 当在给定URL处理功能集合文档时发生错误时,将触发LoadError事件。responseCode参数将包含一个HTTP状态码,而errorMessage参数将包含详细的错误消息。
  • 获取物体集合完成 GotFeatures 网址 url: 文本, 物体列表 features: 列表 当从给定URL成功读取功能集合时,将运行GotFeatures事件。features参数将是一个功能描述列表,这些描述可以使用FeatureFromDescription方法转换为组件。

方法

  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 暂无描述
  • 移动到 MoveToContainer 容器 container: 布局 暂无描述
  • 从网址加载 LoadFromURL 网址 url: 文本 从给定URL加载GeoJSON格式的要素集合。若成功,将引发GotFeatures事件,并附带给定URL以及从GeoJSON解析出的要素列表,该列表以(键, 值)对的形式呈现。若失败,将引发LoadError事件,并附带任何适用的HTTP响应码和错误消息。
  • 从描述加载 FeatureFromDescription 任意 描述 description: 列表 将功能描述转换为App Inventor地图功能。目前仅此一项
  • 创建圆形 CreateCircle 组件 创建"圆形"组件
  • 创建线条 CreateLineString 组件 创建"线条"组件
  • 创建标记 CreateMarker 组件 纬度 latitude: 数字, 经度 longitude: 数字 在指定的纬度和经度上创建一个具有默认属性的新标记。
  • 创建多边形 CreatePolygon 组件 创建"多边形"组件
  • 创建矩形 CreateRectangle 组件 创建"矩形"组件