你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 Java 的 Azure Maps SDK 提升客户端库 - 版本 1.0.0-beta.2

项目
09/22/2023

（不推荐使用）

Azure Maps适用于 Java 的 SDK 提升客户端库。

此包包含Azure Maps SDK 提升客户端库，其中包含Azure Maps提升 API。有关如何使用此包的文档，请参阅Azure Maps提升 REST API。

源代码 | API 参考文档 | REST API 文档 | 产品文档 | 样品

重要

请注意，此包已弃用，在 2023 年 5 月 5 日之后将不再提供服务或维护。所有其他Azure Maps API、服务和 TilesetID 不受此停用的影响。有关升级的指导，请参阅迁移指南提升服务停用。有关更多详细信息，请参阅我们的弃用策略 (https://aka.ms/azsdk/support-policies) 。

文档

提供了各种文档来帮助你入门

API 参考文档

入门

先决条件

将包添加到产品

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-maps-elevation</artifactId>
    <version>1.0.0-beta.2</version>
</dependency>

包括建议的包

Azure 管理库需要 TokenCredential 用于身份验证的实现和 HttpClient HTTP 客户端的实现。

Azure 标识包和 Azure Core Netty HTTP 包提供默认实现。

身份验证

默认情况下，Azure Active Directory 令牌身份验证依赖于以下环境变量的正确配置。

AZURE_CLIENT_ID 用于 Azure 客户端 ID。
AZURE_TENANT_ID 用于 Azure 租户 ID。
AZURE_CLIENT_SECRET 或 AZURE_CLIENT_CERTIFICATE_PATH ，用于客户端密码或客户端证书。

此外，可以通过环境变量 AZURE_SUBSCRIPTION_ID配置 Azure 订阅 ID。

使用上述配置， azure 可以通过以下代码对客户端进行身份验证：

// Authenticates using Azure AD building a default credential
// This will look for AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_CLIENT_SECRET env variables
DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();

// Creates a client
ElevationClient client = new ElevationClientBuilder()
    .credential(tokenCredential)
    .elevationClientId(System.getenv("MAPS_CLIENT_ID"))
    .buildClient();

示例代码假定全局 Azure。否则，请更改 AzureEnvironment.AZURE 变量。

有关更多选项，请参阅身份验证。

关键概念

有关 Azure 管理库的设计和关键概念的一般介绍，请参阅 API 设计。

示例

获取点的数据

client.getDataForPoints(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.68853362143818, 46.856464798637127)));

获取折线的数据

client.getDataForPolyline(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.65853362143818, 46.85646479863713)), 5);

获取边界框的数据

client.getDataForBoundingBox(new GeoBoundingBox(-121.668533621438, 46.8464647986371,
    -121.658533621438, 46.8564647986371), 3, 3);

疑难解答

与 Azure Maps 服务交互时，地图服务返回的错误对应于为 REST API 请求返回的相同 HTTP 状态代码。

例如，如果使用无效坐标进行搜索，则会返回错误，指示“错误请求”。400

后续步骤

SDK 的 GitHub 存储库中提供了多个Azure Maps提升 Java SDK 示例。 Azure Maps高程示例

贡献

有关参与此存储库的详细信息，请参阅参与指南。

分支
创建功能分支 (git checkout -b my-new-feature)
() git commit -am 'Add some feature' 提交更改
推送到分支 (git push origin my-new-feature)
创建新的拉取请求

曝光数

通过