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

Azure Maps适用于 .NET 的通用客户端库 - 版本 1.0.0-beta.4

Azure Maps是一项 Microsoft 托管服务,提供地图服务,

Azure.Maps.Common 库提供在其他Azure Maps客户端库之间共享的基础结构。

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

入门

安装包

安装要与 NuGet 一起使用的适用于 .NET 的 Azure Maps 客户端库,Azure.Maps.Common客户端库将包括在内。 选择要安装的包:

dotnet add package Azure.Maps.Search --prerelease
dotnet add package Azure.Maps.Routing --prerelease
dotnet add package Azure.Maps.Rendering --prerelease
dotnet add package Azure.Maps.Geolocation --prerelease

先决条件

必须具有 Azure 订阅Azure Maps帐户

若要创建新的Azure Maps帐户,可以使用 Azure 门户、Azure PowerShell或 Azure CLI。 下面是使用 Azure CLI 的示例:

az maps account create --kind "Gen2" --account-name "myMapAccountName" --resource-group "<resource group>" --sku "G2"

验证客户端

可通过两种方式对客户端进行身份验证:共享密钥身份验证和 Azure AD。 有关详细说明,请参阅其他Azure Maps包。

关键概念

Azure Maps Common 客户端库包含 LocalizedMapViewRequestFailedException 等共享基础结构。

线程安全

我们保证所有客户端实例方法都是线程安全的,并且彼此独立 (准则) 。 这可确保重用客户端实例的建议始终是安全的,即使在线程之间也是如此。

其他概念

客户端选项 | 访问响应 | 长时间运行的操作 | 处理失败 | 诊断 | 嘲笑 | 客户端生存期

示例

请参阅 搜索路由渲染地理位置的示例。

疑难解答

如果实例化 , nullLocalizedMapView则程序将引发错误 ArgumentNullException

后续步骤

开始使用我们的 搜索路由渲染地理位置 示例。

供稿

有关构建、测试和参与此库的详细信息,请参阅 CONTRIBUTING.md

本项目欢迎贡献和建议。 大多数贡献要求你同意贡献者许可协议 (CLA),并声明你有权(并且确实有权)授予我们使用你的贡献的权利。 有关详细信息,请访问 <cla.microsoft.com>。

提交拉取请求时,CLA 机器人将自动确定你是否需要提供 CLA,并相应地修饰 PR(例如标签、注释)。 直接按机器人提供的说明操作。 只需使用 CLA 对所有存储库执行一次这样的操作。

此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息,请参阅行为准则常见问题解答,或如果有任何其他问题或意见,请与 联系。

曝光数