OpenStreetMapImageryProvider

new Cesium.OpenStreetMapImageryProvider(options)
engine/Source/Scene/OpenStreetMapImageryProvider.js 59

提供由 OpenStreetMap 托管的平铺图像的图像提供商 或其他 Slippy 磁贴提供商。 默认 URL 连接到 OpenStreetMap 的志愿者运营 服务器，因此您必须符合其 Tile Usage Policy.
Name Type Description
options OpenStreetMapImageryProvider.ConstructorOptions 描述初始化选项的对象
Throws:
  • DeveloperError : rectangle 和 minimumLevel 指示 minimum 级别有四个以上的图块。不支持在最低级别具有四个以上切片的影像提供者。
Example:
const osm = new Cesium.OpenStreetMapImageryProvider({
    url : 'https://tile.openstreetmap.org/'
});
See:

Extends

Members

readonly credit : Credit
engine/Source/Scene/UrlTemplateImageryProvider.js 482

获取此影像提供程序处于活动状态时要显示的点数。 通常，这用于贷记 图像的来源。
Inherited From:
Default Value: undefined

enablePickFeatures : boolean
engine/Source/Scene/UrlTemplateImageryProvider.js 269

获取或设置一个值，该值指示是否启用功能选取。 如果为 true，则 UrlTemplateImageryProvider#pickFeatures 将 请求 options.pickFeaturesUrl 并尝试解释响应中包含的功能。 如果为 false，则 UrlTemplateImageryProvider#pickFeatures 将立即返回 undefined(表示没有可选取的) 功能)，而无需与服务器通信。 如果您知道您的数据，请将此属性设置为 false Source 不支持选取功能，或者您不希望此提供程序的功能可选取。
Inherited From:
Default Value: true

readonly errorEvent : Event
engine/Source/Scene/UrlTemplateImageryProvider.js 468

获取在影像提供程序遇到异步错误时引发的事件。 通过订阅 时，您将收到错误通知，并可能从中恢复。 事件侦听器 将传递 TileProviderError 的实例。
Inherited From:

readonly hasAlphaChannel : boolean
engine/Source/Scene/UrlTemplateImageryProvider.js 499

获取一个值，该值指示此图像提供程序是否提供图像 包括 Alpha 通道。 如果此属性为 false，则 Alpha 通道(如果存在)将 被忽略。 如果此属性为 true，则将处理任何没有 Alpha 通道的图像 就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时，内存使用情况 和纹理上传时间缩短。
Inherited From:
Default Value: true

readonly maximumLevel : number|undefined
engine/Source/Scene/UrlTemplateImageryProvider.js 400

获取可请求的最大详细级别，如果没有限制，则为 undefined。
Inherited From:
Default Value: undefined

readonly minimumLevel : number
engine/Source/Scene/UrlTemplateImageryProvider.js 413

获取可请求的最小详细级别。
Inherited From:
Default Value: 0

readonly pickFeaturesUrl : string
engine/Source/Scene/UrlTemplateImageryProvider.js 348

获取用于选取功能的 URL 模板。 如果未指定此属性， UrlTemplateImageryProvider#pickFeatures 将立即返回 undefined，表示没有 精选功能。 URL 模板支持 UrlTemplateImageryProvider#url 属性，以及以下内容：
  • {i}：选取位置的像素列(水平坐标)，其中最西端的像素为 0。
  • {j}：选取位置的像素行(垂直坐标)，其中最北端的像素为 0。
  • {reverseI}：选取位置的像素列(水平坐标)，其中最东端的像素为 0。
  • {reverseJ}：选取位置的像素行(垂直坐标)，其中最南端的像素为 0。
  • {longitudeDegrees}：选取位置的经度(以度为单位)。
  • {latitudeDegrees}：选取位置的纬度(以度为单位)。
  • {longitudeProjected}：切片方案的投影坐标中选取的位置的经度。
  • {latitudeProjected}：切片方案的投影坐标中选取的位置的纬度。
  • {format}：用于获取特征信息的格式，在 GetFeatureInfoFormat 中指定。
Inherited From:

readonly proxy : Proxy
engine/Source/Scene/UrlTemplateImageryProvider.js 361

获取此提供程序使用的代理。
Inherited From:
Default Value: undefined

readonly rectangle : Rectangle
engine/Source/Scene/UrlTemplateImageryProvider.js 439

获取此实例提供的图像的矩形(以弧度为单位)。
Inherited From:
Default Value: tilingScheme.rectangle

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/UrlTemplateImageryProvider.js 454

获取瓦片丢弃策略。 如果未 undefined，则 discard 策略负责 用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能 返回 undefined，不过滤任何图块。
Inherited From:
Default Value: undefined

readonly tileHeight : number
engine/Source/Scene/UrlTemplateImageryProvider.js 387

获取每个图块的高度(以像素为单位)。
Inherited From:
Default Value: 256

readonly tileWidth : number
engine/Source/Scene/UrlTemplateImageryProvider.js 374

获取每个图块的宽度(以像素为单位)。
Inherited From:
Default Value: 256

readonly tilingScheme : TilingScheme
engine/Source/Scene/UrlTemplateImageryProvider.js 426

获取此提供程序使用的切片方案。
Inherited From:
Default Value: new WebMercatorTilingScheme()

readonly url : string
engine/Source/Scene/UrlTemplateImageryProvider.js 298

获取用于请求磁贴的 URL 模板。 它具有以下关键字：
  • {z}：切片方案中切片的级别。 零级是四叉树金字塔的根。
  • {x}：切片方案中的切片 X 坐标，其中 0 是最西边的切片。
  • {y}：平铺方案中的瓦片 Y 坐标，其中 0 是最北端的瓦片。
  • {s}：可用的子域之一，用于克服浏览器对每个主机同时请求数量的限制。
  • {reverseX}：平铺方案中的瓦片 X 坐标，其中 0 是最东边的瓦片。
  • {reverseY}：平铺方案中的瓦片 Y 坐标，其中 0 是最南端的瓦片。
  • {reverseZ}：切片方案中切片的级别，其中级别 0 是四叉树金字塔的最大级别。 要使用 reverseZ，必须定义 maximumLevel。
  • {westDegrees}：瓦片的西边，以大地测量度为单位。
  • {southDegrees}：瓦片的南部边缘，以大地测量度为单位。
  • {eastDegrees}：瓦片的东边，以大地测量度为单位。
  • {northDegrees}：瓦片的北部边缘，以大地测量度为单位。
  • {westProjected}：切片方案的投影坐标中切片的西部边缘。
  • {southProjected}：切片方案的投影坐标中切片的南部边缘。
  • {eastProjected}：切片方案的投影坐标中切片的东边缘。
  • {northProjected}：切片方案的投影坐标中切片的北部边缘。
  • {width}：每个图块的宽度(以像素为单位)。
  • {height}：每个图块的高度(以像素为单位)。
Inherited From:

readonly urlSchemeZeroPadding : object
engine/Source/Scene/UrlTemplateImageryProvider.js 322

获取每个图块坐标的 URL 方案零填充。格式为 '000'，其中每个坐标都将填充 左侧带有 0 以匹配传递的 0 字符串的宽度。例如：设置： urlSchemeZeroPadding ： { '{x}' ： '0000'} 将导致 'x' 值 12 返回生成的 URL 中 {x} 的字符串 '0012'。 它有以下关键词：
  • {z}：切片方案中瓦片级别的零填充。
  • {x}：平铺方案中图块 X 坐标的零填充。
  • {y}：平铺方案中图块 Y 坐标的零填充。
  • {reverseX}：平铺方案中图块 reverseX 坐标的零填充。
  • {reverseY}：平铺方案中图块 reverseY 坐标的零填充。
  • {reverseZ}：平铺方案中瓦片的 reverseZ 坐标的零填充。
Inherited From:

Methods

getTileCredits(x, y, level) → Array.<Credit>
engine/Source/Scene/UrlTemplateImageryProvider.js 514

获取在显示给定磁贴时要显示的制作者名单。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别;
Returns:
显示磁贴时要显示的制作者名单。
Inherited From:

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
engine/Source/Scene/UrlTemplateImageryProvider.js 552

异步确定哪些要素(如果有)位于给定的经度和纬度 一个图块。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
longitude number 选取特征的经度。
latitude number 选取特征的纬度。
Returns:
对所选特征的 Promise，当异步 拣选完成。 解析的值是 ImageryLayerFeatureInfo 的数组 实例。 如果在给定位置未找到要素，则数组可能为空。 如果不支持拣选，也可能为 undefined。
Inherited From:

requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
engine/Source/Scene/UrlTemplateImageryProvider.js 526

Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
当镜像可用时将解析的镜像的 Promise，或者 undefined 如果对服务器的活动请求过多，则应稍后重试该请求。
Inherited From:

Type Definitions

Cesium.OpenStreetMapImageryProvider.ConstructorOptions
engine/Source/Scene/OpenStreetMapImageryProvider.js 14

OpenStreetMapImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url string <optional>
 'https：//tile.openstreetmap.org' OpenStreetMap 服务器 url。
fileExtension string <optional>
 'png' 服务器上图片的文件扩展名。
retinaTiles boolean <optional>
 false 如果为 true，则为 Retina 显示屏请求 2 倍分辨率的平铺。
rectangle Rectangle <optional>
 Rectangle.MAX_VALUE 图层的矩形。
minimumLevel number <optional>
 0 图像提供商支持的最低细节层次。
maximumLevel number <optional>
 图像提供商支持的最大细节层次，如果没有限制，则为 undefined。
ellipsoid Ellipsoid <optional>
 椭球体。 如果未指定，则使用 WGS84 椭球体。
credit Credit | string <optional>
 'MapQuest, Open Street Map and contributors, CC-BY-SA' 数据源的制作者名单，显示在画布上。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets