Tileset - Create

Gilt für: Siehe Tarife.

Creator ermöglicht die Entwicklung von Anwendungen basierend auf Ihren privaten Gebäudeplandaten mithilfe Azure Maps API und SDK. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Maps Creator gelten.

In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Maps Creator gelten.

Mit der Kachelseterstellungs-API kann der Aufrufer ein Kachelset aus einem Dataset erstellen. Ein Kachelset enthält eine Reihe von Kacheln, die von der Kachel "Karte abrufen" genutzt werden können, um benutzerdefinierte Kacheln abzurufen. Verwenden Sie zum Erstellen eines Datasets die DataSet Create-API.

Create Request übermitteln

Um Ihr Kachelsatz zu erstellen, stellen Sie eine POST Anforderung mit einem leeren Text. Der datasetId Abfrageparameter wird als Quelle der Kachelsatzdaten verwendet.

Die API zum Erstellen von Kacheln ist eine Anforderung mit langer Ausführungslaufzeit.

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-Parameter

Name In Required Type Description
geography
path True
  • string

Dieser Parameter gibt an, wo sich die Azure Maps Creator-Ressource befindet. Gültige Werte sind us und eu.

api-version
query True
  • string

Versionsnummer der Azure Maps-API. Aktuelle Version ist 2.0

datasetId
query True
  • string

Der eindeutige datasetId , den das Kachelsatz erstellt, mit dem die API Features zum Generieren von Kacheln abruft. Muss datasetId von einem erfolgreichen Api-Aufruf für die Dataseterstellung abgerufen worden sein.

description
query
  • string

Der Benutzer hat eine Beschreibung des Kachelets bereitgestellt.

subscription-key
query
  • string

Einer der Azure Maps Schlüssel, die von einem Azure-Zuordnungskonto bereitgestellt werden. Ausführliche Informationen zum Verwalten der Authentifizierung finden Sie in diesem Artikel.

Anforderungsheader

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

Gibt an, welches Konto für die Verwendung in Verbindung mit dem Azure AD-Sicherheitsmodell vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus Azure Maps Konto-API der Verwaltungsebene abgerufen werden. Informationen zur Verwendung Azure AD Sicherheit in Azure Maps finden Sie in den folgenden Artikeln.

Antworten

Name Type Description
202 Accepted

Anforderung akzeptiert: Die Anforderung wurde zur Verarbeitung akzeptiert. Verwenden Sie die URL im Operation-Location Header, um den Status abzurufen.

Headers

  • Operation-Location: string
400 Bad Request

Ungültige Anforderung: Mindestens ein Parameter wurde falsch angegeben oder schließen sich gegenseitig aus.

401 Unauthorized

Der Zugriff wurde aufgrund eines ungültigen Abonnementschlüssels oder eines ungültigen Azure Active Directory Bearertokens verweigert. Stellen Sie sicher, dass Sie einen gültigen Schlüssel für ein aktives Azure-Abonnement und eine Maps-Ressource angeben. Überprüfen Sie andernfalls den WWW-Authenticate-Header auf Fehlercode und Beschreibung des bereitgestellten AAD-Bearertokens.

Headers

  • WWW-Authenticate: string
403 Forbidden

Berechtigungs-, Kapazitäts- oder Authentifizierungsprobleme.

404 Not Found

Nicht gefunden: Die angeforderte Ressource wurde nicht gefunden, aber sie ist in Zukunft möglicherweise wieder verfügbar.

500 Internal Server Error

Bei der Verarbeitung der Anforderung ist ein Fehler aufgetreten. Versuchen Sie es später noch mal.

Sicherheit

azure_auth

Dies sind die Azure Active Directory OAuth2-Flows. In Kombination mit der rollenbasierten Zugriffssteuerung von Azure kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps Ressourcenkonto oder untergeordnete Ressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder jedem Dienstprinzipal kann Zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus mindestens einer Berechtigung für Azure Maps REST-APIs besteht.

Um Szenarien zu implementieren, empfehlen wir die Anzeige von Authentifizierungskonzepten. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die zugriffssteuerungsfähig für bestimmte APIs und Bereiche sind.

Hinweis

  • Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id -Headers, um anzugeben, auf welche Azure Maps Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltungs-APIerworben werden.
  • ist Authorization URL spezifisch für die öffentliche Azure-Cloudinstanz. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Azure Active Directory-Konfigurationen.
  • Die rollenbasierte Zugriffssteuerung in Azure wird über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.
  • Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.
  • Derzeit werden Azure Active Directory v1.0-Token unterstützt.

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

subscription-key

Dies ist ein gemeinsam verwendeter Schlüssel, der beim Erstellen einer Azure Maps Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs bereitgestellt wird. Mit diesem Schlüssel ist jede Anwendung berechtigt, auf alle REST-APIs zuzugreifen. Anders ausgedrückt: Diese können derzeit als Hauptschlüssel für das Konto behandelt werden, für das sie ausgestellt werden. Für öffentlich verfügbar gemachte Anwendungen empfiehlt es sich, den Server-to-Server-Zugriff auf Azure Maps REST-APIs zu verwenden, in denen dieser Schlüssel sicher gespeichert werden kann.

Type: apiKey
In: query

Beispiele

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."
  }
}

Definitionen

ODataError

Dieses Objekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.

ODataErrorResponse

Dieses Antwortobjekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.

ODataError

Dieses Objekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.

Name Type Description
code
  • string

Der ODataError-Code.

details

Dieses Objekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.

message
  • string

Sofern verfügbar eine lesbare Beschreibung des Fehlers.

target
  • string

Falls verfügbar, verursacht das Ziel den Fehler.

ODataErrorResponse

Dieses Antwortobjekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.

Name Type Description
error

Dieses Objekt wird zurückgegeben, wenn in der Maps-API ein Fehler auftritt.