提供OpenStreetMap托管的平铺图像的图像提供程序或其他Slippy瓷砖提供商。默认URL连接到OpenStreetMap的自愿运行服务器,因此您必须遵守他们的
瓷砖使用政策
。
Name | Type | Description |
---|---|---|
options
|
OpenStreetMapImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
Throws:
-
DeveloperError :矩形和minimumLevel表示最小级别有四个以上的图块。不支持最低级别具有四个以上图块的图像提供程序。
Example:
var osm = new LSGlobe.OpenStreetMapImageryProvider({
url : 'https://a.tile.openstreetmap.org/'
});
See:
Extends
Members
readonly credit : Credit
获取此图像提供者处于活动状态时要显示的功劳。通常,这用于记入图像的来源。在
UrlTemplateImageryProvider#ready
返回true之前,不应调用此函数。
- Inherited From:
- Default Value:
undefined
此提供程序的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
- Inherited From:
- Default Value:
undefined
此提供程序的默认亮度。 1.0使用未修改的图像颜色。小于1.0使图像更暗,而大于1.0则使图像更亮。
- Inherited From:
- Default Value:
undefined
此提供程序的默认对比。 1.0使用未修改的图像颜色。小于1.0减少大于1.0时,对比度增加。
- Inherited From:
- Default Value:
undefined
此提供程序的全球日期的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
- Inherited From:
- Default Value:
undefined
适用于此提供程序的默认伽玛校正。 1.0使用未修改的图像颜色。
- Inherited From:
- Default Value:
undefined
此提供程序的默认色调(以弧度为单位)。 0.0使用未修改的图像颜色。
- Inherited From:
- Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
应用于该提供程序的默认纹理放大滤镜。
- Inherited From:
- Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
应用于该提供程序的默认纹理缩小过滤器。
- Inherited From:
- Default Value:
undefined
此提供程序的地球仪夜间的默认alpha混合值,其中0.0表示完全透明,1.0表示完全不透明。
- Inherited From:
- Default Value:
undefined
此提供程序的默认饱和度。 1.0使用未修改的图像颜色。小于1.0会降低饱和度大于1.0时会增加饱和度。
- Inherited From:
- Default Value:
undefined
获取或设置一个值,该值指示是否启用功能选择。如果为true,
UrlTemplateImageryProvider#pickFeatures
将请求
options.pickFeaturesUrl
并尝试解释响应中包含的功能。如果为假,
UrlTemplateImageryProvider#pickFeatures
会立即返回未定义(表示没有可拾取的内容)功能)而无需与服务器通信。如果您知道数据,则将此属性设置为false源不支持选择功能,或者您不希望该提供程序的功能可供选择。
- Inherited From:
- Default Value:
true
readonly errorEvent : Event
获取当图像提供程序遇到异步错误时引发的事件。通过订阅针对该事件,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了
TileProviderError
的实例。
- Inherited From:
获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理任何没有alpha通道的图像好像他们的alpha到处都是1.0。当此属性为false时,内存使用情况并且减少了纹理上载时间。该功能应在
ImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
true
获取可以请求的最大详细级别,如果没有限制,则为未定义。在
UrlTemplateImageryProvider#ready
返回true之前,不应调用此函数。
- Inherited From:
- Default Value:
undefined
获取可以请求的最低详细程度。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
0
获取用于选择特征的URL模板。如果未指定此属性,
UrlTemplateImageryProvider#pickFeatures
将立即返回undefined,表示没有功能选择。该网址模板支持该广告系列支持的所有关键字
UrlTemplateImageryProvider#url
属性,以及以下内容:
-
{i}
:所选位置的像素列(水平坐标),其中最西端的像素为0。 -
{j}
:所选位置的像素行(垂直坐标),其中最北端的像素为0。 -
{reverseI}
:所选位置的像素列(水平坐标),其中最东端的像素为0。 -
{reverseJ}
:所选位置的像素行(垂直坐标),其中最南端的像素为0。 -
{longitudeDegrees}
:所选位置的经度(以度为单位)。 -
{latitudeDegrees}
:所选位置的纬度(以度为单位)。 -
{longitudeProjected}
:在平铺方案的投影坐标中所拾取位置的经度。 -
{latitudeProjected}
:在平铺方案的投影坐标中所拾取位置的纬度。 -
{format}
:获取功能信息的格式,如GetFeatureInfoFormat
中所指定。
- Inherited From:
readonly proxy : Proxy
获取此提供程序使用的代理。
- Inherited From:
- Default Value:
undefined
获取一个值,该值指示提供者是否已准备好使用。
- Inherited From:
获取一个在提供程序准备好使用时解析为true的承诺。
- Inherited From:
readonly rectangle : Rectangle
获取此实例提供的图像的矩形(以弧度表示)。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
tilingScheme.rectangle
readonly tileDiscardPolicy : TileDiscardPolicy
获取切片丢弃策略。如果未定义,则丢弃策略负责用于通过其shouldDiscardImage函数过滤掉'缺失'的图块。如果这个功能返回未定义,不过滤任何图块。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
undefined
获取每个图块的高度,以像素为单位。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
256
获取每个图块的宽度,以像素为单位。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
256
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
- Inherited From:
- Default Value:
new WebMercatorTilingScheme()
获取用于请求图块的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:
获取每个图块坐标的URL方案零填充。格式为'000',其中每个坐标都将被填充左边的零与传递的零字符串的宽度匹配。例如设置:urlSchemeZeroPadding:{'{x}':'0000'}将导致'x'值为12,以在生成的URL中返回{x}的字符串'0012'。它具有以下关键字:
-
{z}
:切片方案中图块级别的零填充。 -
{x}
:切片方案中图块X坐标的零填充。 -
{y}
:切片方案中图块Y坐标的零填充。 -
{reverseX}
:在平铺方案中图块reverseX坐标的零填充。 -
{reverseY}
:在切片方案中,图块反向Y坐标的零填充。 -
{reverseZ}
:在切片方案中,图块的reverseZ坐标的零填充。
- Inherited From:
Methods
getTileCredits (x, y, level) → Array.< Credit >
获取显示给定图块时要显示的信用。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别; |
Returns:
显示图块时要显示的积分。
Throws:
-
DeveloperError :
getTileCredits
影像提供者准备就绪之前,不得调用它。
- Inherited From:
pickFeatures (x, y, level, longitude, latitude) → Promise.<Array.< ImageryLayerFeatureInfo >>|undefined
异步确定哪些要素(如果有)位于给定的经度和纬度内瓷砖。在
ImageryProvider#ready
返回true之前,不应调用此函数。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别。 |
longitude
|
Number | 选择要素的经度。 |
latitude
|
Number | 选择要素的纬度。 |
Returns:
对所选择功能的承诺将在异步时解决 采摘完成。解析值是一个数组
ImageryLayerFeatureInfo
实例。如果在给定位置找不到要素,则数组可能为空。 如果不支持拣配,则它也可能是未定义的。
- Inherited From:
重新初始化该实例。支持重新初始化已在使用的实例,但不支持推荐使用,因为图像提供商提供的现有图块将不会更新。
Name | Type | Description |
---|---|---|
options
|
Promise.<Object> | Object |
可以传递给
UrlTemplateImageryProvider
构造函数的任何选项。
|
- Inherited From:
请求给定图块的图像。该功能应在
UrlTemplateImageryProvider#ready
返回true之前不会被调用。
Name | Type | Description |
---|---|---|
x
|
Number | 瓦片X坐标。 |
y
|
Number | 瓷砖的Y坐标。 |
level
|
Number | 平铺级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对图像的承诺,将在图像可用时解决,或者 如果对服务器的活动请求过多,并且请求过多,则不确定 应稍后重试。解析的图像可能是 图片或Canvas DOM对象。
- Inherited From:
Type Definitions
OpenStreetMapImageryProvider构造函数的初始化选项
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
url
|
String |
<optional>
|
'https://a.tile.openstreetmap.org' | OpenStreetMap服务器网址。 |
fileExtension
|
String |
<optional>
|
'png' | 服务器上图像的文件扩展名。 |
rectangle
|
Rectangle |
<optional>
|
Rectangle.MAX_VALUE | 图层的矩形。 |
minimumLevel
|
Number |
<optional>
|
0 | 图像提供商所支持的最低详细程度。 |
maximumLevel
|
Number |
<optional>
|
图像提供者支持的最大详细程度,如果没有限制,则未定义。 | |
ellipsoid
|
Ellipsoid |
<optional>
|
椭球。如果未指定,则使用WGS84椭球。 | |
credit
|
Credit | String |
<optional>
|
'MapQuest, Open Street Map and contributors, CC-BY-SA' | 数据源的信用,显示在画布上。 |