Tiler Points - Get Lon Lat

服务:

Planetary Computer

API 版本:

2025-04-30-preview

获取数据集的 Point 值。

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/point/{lon},{lat}?api-version=2025-04-30-preview

具有可选参数:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/point/{lon},{lat}?api-version=2025-04-30-preview&assets={assets}&expression={expression}&assetBidx={assetBidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&coord-crs={coord-crs}&resampling={resampling}

URI 参数

名称	在	必需	类型	说明
collectionId	path	True	string maxLength: 500 pattern: .*	STAC 集合标识符
itemId	path	True	string maxLength: 500 pattern: .*	STAC 项标识符
lat	path	True	number (float)	纬度
lon	path	True	number (double)	经度
api-version	query	True	string minLength: 1	用于此作的 API 版本。
asset_as_band	query		boolean	资产作为带
assetBidx	query		string[]	按资产区间索引（昏迷分隔索引）
assets	query		string[]	资产的名称。
coord-crs	query		string	输入坐标的坐标参考系统。 默认为 epsg:4326。
expression	query		string	资产之间的波段数学表达式
nodata	query		number (float)	覆盖内部 Nodata 值
resampling	query		Resampling	重新采样方法。
unscale	query		boolean	应用内部缩放或偏移

响应

名称	类型	说明
200 OK	TitilerCoreModelsResponsesPoint	请求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	意外的错误响应。 标头 x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://geocatalog.spatio.azure.com/.default

示例

TilerPoints_GetLonLat

示例请求

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{{collectionId}}/items/{{itemId}}/point/-65.75381224878205,18.252615371961497?api-version=2025-04-30-preview

示例响应

状态代码:

200

{
  "coordinates": [
    -65.75381224878205,
    18.252615371961497
  ],
  "values": [
    0
  ],
  "band_names": [
    "data_b1"
  ]
}

定义

名称	说明
Azure.Core.Foundations.Error	错误对象。
Azure.Core.Foundations.ErrorResponse	包含错误详细信息的响应。
Azure.Core.Foundations.InnerError	包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。
Resampling	以不同分辨率读取源栅格数据时使用的重采样算法
TitilerCoreModelsResponsesPoint	点模型。 endpoints 的 /point 响应模型用于在特定位置提供值的 point query作的响应模型

Azure.Core.Foundations.Error

Object

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	有关错误的可读的表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

Object

包含错误详细信息的响应。

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

Object

包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	Azure.Core.Foundations.InnerError	内部错误。

Resampling

枚举

以不同分辨率读取源栅格数据时使用的重采样算法

值	说明
average	平均重采样 - 计算所有参与像素的平均值
bilinear	双线性插值 - 使用 2x2 输入像元的加权平均值计算输出值
cubic	三次插值 - 使用 4x4 输入单元格的加权平均值以获得更平滑的结果
cubic_spline	三次样条插值 - 类似于三次，但更好地保留了边缘
gauss	高斯加权重新采样 - 将高斯加权应用于参与像素
lanczos	Lanczos 窗口 sinc 重采样 - 高质量，最少的伪影
mode	模式重新采样 - 从贡献像素中选择最常见的值
nearest	最邻近 - 选择最接近像素值的最快方法
rms	均方根重采样 - 用于重采样误差或偏差网格

TitilerCoreModelsResponsesPoint

Object

点模型。

endpoints 的 /point 响应模型用于在特定位置提供值的 point query作的响应模型

名称	类型	说明
band_names	string[]	栅格数据中每个波段的名称
coordinates	number[] (float)	查询点的地理坐标 [经度、纬度]
values	number[] (float)	每个波段的查询点处的像素值数组