您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Tileset - Create

适用于:请参阅 定价

利用 Creator,可以基于专用室内地图数据使用 Azure Maps API 和 SDK 开发应用程序。 本文 介绍适用于 Azure Maps Creator 的概念和工具。

本文 介绍适用于 Azure Maps Creator 的概念和工具。

图块集创建 API 允许调用方从数据集创建图块集。 图块集包含一组磁贴,可以从获取地图图块 使用这些图 块来检索自定义图块。 若要创建数据集,请使用 数据集创建 API

提交创建请求

若要创建图块集,需要 POST 提出正文为空的请求。 datasetId查询参数将用作图块集数据的源。

创建图块集 API 是 一个长时间运行的请求

POST https://{geography}.atlas.microsoft.com/tilesets?api-version=2.0&datasetId={datasetId}
POST https://{geography}.atlas.microsoft.com/tilesets?subscription-key={subscription-key}&api-version=2.0&datasetId={datasetId}&description={description}

URI 参数

Name In Required Type Description
geography
path True
  • string

此参数指定 Azure Maps Creator 资源的位置。 有效值为 us 和 eu。

api-version
query True
  • string

API Azure Maps版本号。 当前版本为 2.0

datasetId
query True
  • string

datasetId 块集创建 API 用来检索功能以生成磁贴的唯一 。 datasetId必须从成功的数据集创建 API 调用获取

description
query
  • string

用户提供了磁贴集的说明。

subscription-key
query
  • string

Azure 映射Azure Maps提供的密钥之一。 请参阅本文 详细了解如何管理身份验证。

请求头

Name Required Type Description
x-ms-client-id
  • string

指定要与安全模型配合使用Azure AD帐户。 它表示帐户的唯Azure Maps ID,可以从管理平面帐户 API Azure Maps检索。 若要在Azure AD安全性Azure Maps请参阅以下 文章了解 指导。

响应

Name Type Description
202 Accepted

请求已接受:已接受请求进行处理。 请使用标头中的 URL Operation-Location获取状态。

Headers

  • Operation-Location: string
400 Bad Request

错误的请求:一个或多个参数未正确指定或互斥。

401 Unauthorized

由于订阅密钥无效或用户令牌Azure Active Directory访问被拒绝。 请确保为活动的 Azure 订阅和 Maps 资源提供有效密钥。 否则,请验证 WWW-Authenticate 标头,获取错误代码和提供的 AAD bearer 令牌的说明。

Headers

  • WWW-Authenticate: string
403 Forbidden

权限、容量或身份验证问题。

404 Not Found

找不到:找不到请求的资源,但将来可能再次可用。

500 Internal Server Error

处理该请求时出错。 请稍后再试。

安全性

azure_auth

这些是 OAuth2 Azure Active Directory流 。 与 Azure 基于 角色的访问控制 配对时,可以使用它来控制对 Azure Maps REST API 的访问。 Azure 基于角色的访问控制用于指定对一个或多个Azure Maps资源帐户或子资源的访问权限。 可以通过内置角色或由一个或多个 REST API 权限组成的自定义角色授予任何用户、组Azure Maps访问权限。

若要实现方案,建议查看 身份验证概念。 总之,此安全定义提供了一种解决方案,用于通过 (API 和) 访问控制的对象对应用程序进行建模。

注意

  • 此安全 定义 需要使用 标头来指示Azure Maps x-ms-client-id 请求访问的资源。 这可以从地图管理 API 获取
  • Authorization URL特定于 Azure 公有云实例。 主权云具有唯一的授权 URL 和 Azure Active Directory 配置。
  • Azure 基于角色的访问控制通过 azure 管理平面通过 Azure 门户、Powershell、CLI、Azure SDK 或 REST API 进行配置。
  • 使用 Azure Maps Web SDK, 可以针对多个用例设置基于配置的应用程序。
  • 目前Azure Active Directory v1.0 令牌。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

subscription-key

这是通过 Azure 管理平面通过 Azure Maps、Powershell、CLI、Azure SDK 或 REST API Azure 门户资源时预配的共享密钥。 通过此密钥,任何应用程序都有权访问所有 REST API。 换句话说,目前可以将这些密钥视为颁发这些密钥的帐户的主密钥。 对于公开公开的应用程序,建议使用服务器对可安全存储此密钥Azure Maps REST API 的服务器访问权限。

Type: apiKey
In: query

示例

Create Tileset by providing a Dataset Id

Sample Request

POST https://us.atlas.microsoft.com/tilesets?subscription-key=[subscription-key]&api-version=2.0&datasetId=[dataset-Id]

Sample Response

Operation-Location: https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2.0
Access-Control-Expose-Headers: Operation-Location
{
  "error": {
    "code": "400 BadRequest",
    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
  }
}
{
  "error": {
    "code": "401 Unauthorized",
    "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
  }
}
{
  "error": {
    "code": "403 Forbidden",
    "message": "Permission, capacity, or authentication issues."
  }
}
{
  "error": {
    "code": "404 NotFound",
    "message": "Not Found: the requested resource could not be found, but it may be available again in the future."
  }
}
{
  "error": {
    "code": "500 InternalServerError",
    "message": "An error occurred while processing the request. Please try again later."
  }
}

定义

ODataError

当 Maps API 中发生错误时,将返回此对象。

ODataErrorResponse

当 Maps API 中发生错误时,将返回此响应对象。

ODataError

当 Maps API 中发生错误时,将返回此对象。

Name Type Description
code
  • string

ODataError 代码。

details

当 Maps API 中发生错误时,将返回此对象。

message
  • string

在适用的情况下,将提供该错误的用户可读说明。

target
  • string

如果可用,则返回导致错误的目标。

ODataErrorResponse

当 Maps API 中发生错误时,将返回此响应对象。

Name Type Description
error

当 Maps API 中发生错误时,将返回此对象。