Microsoft Azure
Microsoft Azure Styles API

The Styles API from Microsoft Azure — 6 operation(s) for styles.
Documentation GitHub OpenAPI
OpenAPI Specification

swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Styles API
schemes:
- https
tags:
- name: Styles
paths:
  /styles/mapconfigurations:
    post:
      summary: Microsoft Azure Use To Create A Map Configuration
      description: <br><br>For more information on what a map configuration is, see the [Creator for indoor maps](/azure/azure-maps/creator-indoor-maps#map-configuration) concepts article.<br><br>### Submit Create Request <br><br>The Map Configuration `Create` API is an HTTP `POST` request used to create a new map configuration.
      operationId: microsoftAzureMapconfigurationCreate
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-examples:
        Create a map configuration by providing a configuration file:
          $ref: ./examples/mapconfiguration/MapConfiguration_Create.json
      consumes:
      - application/json
      - application/zip
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/Alias'
      - $ref: '#/parameters/DescriptionMapConfiguration'
      - name: MapConfiguration
        in: body
        description: The configuration file used to create the map configuration. If JSON data format is provided, then the request body should follow [MapConfiguration specification](/rest/api/maps-creator/map-configuration/create?view=rest-maps-creator-2023-03-01-preview&tabs=HTTP#mapconfiguration). If ZIP data format is provided, you should also provide the thumbnail images referenced in the configuration JSON file. ALL files should be put in the root directory of the zip file. The thumbnail image file name should match the thumbnail name provided in the json file. The size limit is 23 MB.
        required: true
        schema:
          $ref: '#/definitions/MapConfiguration'
      responses:
        '202':
          $ref: ../../../Common/preview/1.0/common.json#/responses/202AsyncV2
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
    get:
      summary: Microsoft Azure Use To Get A List Of All Map Configurations
      description: <br><br>### Submit List Request <br><br>The Map Configuration `List` API is an HTTP `GET` request used to get a list of all map configurations.<br><br>
      operationId: microsoftAzureMapconfigurationList
      x-ms-examples:
        Get a list of all map configurations:
          $ref: ./examples/mapconfiguration/MapConfiguration_List.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      x-ms-pageable:
        itemName: mapConfiguration
        nextLinkName: nextLink
      responses:
        '200':
          description: List map configuration request completed successfully. The response body contains a list of all map configurations.
          schema:
            $ref: '#/definitions/MapConfigurationListResult'
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
  /styles/mapconfigurations/{mapConfigurationId}:
    get:
      summary: Microsoft Azure Use To Get A Map Configuration
      description: <br><br>### Submit Get Request <br><br>The Map Configuration `Get` API is an HTTP `GET` request used to get a map configuration. The response contains a zip file with the map configuration JSON and any image files it references. You can always get the default map configuration using predefined alias `defaultIndoor_{tilesetId}` for a given tileset if you deleted the auto-generated map configuration. The two predefined styles used in default map configuration are `microsoft-maps:indoor_2022-01-01` and `microsoft-maps:indoor_dark_2022-01-01`.<br><br>
      operationId: microsoftAzureMapconfigurationGet
      x-ms-examples:
        Gets the details for a single map configuration:
          $ref: ./examples/mapconfiguration/MapConfiguration_Get.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/MapConfigurationId'
      produces:
      - application/zip
      responses:
        '200':
          description: Get map configuration request completed successfully. The response body contains a single map configuration zip file.
          schema:
            type: object
            format: file
            readOnly: true
          headers:
            Content-Type:
              type: string
              description: The content-type for the response.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
    delete:
      summary: Microsoft Azure Use To Delete A Map Configuration
      description: '<br><br>The Map Configuration `Delete` API is an HTTP `DELETE` request used to delete a map configuration. For more information on what a map configuration is, see the [Creator for indoor maps](/azure/azure-maps/creator-indoor-maps#map-configuration) concepts article.<br><br>### Submit Delete Request<br><br>An `HTTP DELETE` request with the `mapConfigurationId` in the path of the request is required to remove an existing map configuration from your Azure Maps account.    <br><br>#### Delete request "Successful"<br><br>The Map Configuration Delete API returns a HTTP `204 No Content` response with an empty body, if the map configuration was deleted successfully.    <br><br>#### Delete request "Failed"<br><br>A HTTP `400 Bad Request` error response will be returned if the map configuration with the passed-in `mapConfigurationId` is not found. <br><br>Here is a sample error response:<br><br><br><br>```json<br>{<br>  "error": {<br>      "code": "400 BadRequest",<br>      "message": "Bad request - MapConfiguration Id: d85b5b27-5fc4-4599-8b50-47160e90f8ce does not exist."<br>  }<br>}<br>```'
      operationId: microsoftAzureMapconfigurationDelete
      x-ms-examples:
        Delete a created map configuration:
          $ref: ./examples/mapconfiguration/MapConfiguration_Delete.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/MapConfigurationId'
      responses:
        '204':
          description: Map configuration delete request completed successfully.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
  /styles/mapconfigurations/operations/{operationId}:
    get:
      summary: Microsoft Azure Use To Check The Status Of The Map Configuration Creation Process
      description: <br><br>The `Get Operation` API is an HTTP `GET` request used to check the status of the map configuration creation process.<br><br>### Submit Operations Request<br><br>To view the current progress of a map configuration operation, you will use a `GET` request where the `operationId` given the path is the ID that represents the operation.<br><br>### Operation Response<br><br>While in progress, a `200-OK` http status code is returned with no extra headers. If the operation succeeds, a `200-OK` http status code is returned with the `Resource-Location` in the header.
      operationId: microsoftAzureMapconfigurationGetoperation
      x-ms-examples:
        Get the status of an operation which is still running:
          $ref: ./examples/mapconfiguration/MapConfiguration_GetOperationStillRunning.json
        Get the status of an operation which has finished successfully:
          $ref: ./examples/mapconfiguration/MapConfiguration_GetOperation.json
      parameters:
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/MapConfigurationOperationId'
      responses:
        '200':
          description: The operation is running or complete. If the operation was successful, use the Resource-Location header to obtain the path to the result.
          schema:
            $ref: ./tileset.json#/definitions/LongRunningOperationResult
          headers:
            Resource-Location:
              type: string
              description: If successful, a URI where details on the newly created resource can be found.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
  /styles:
    post:
      summary: Microsoft Azure Use To Create An Azure Maps Style
      description: <br><br>## Submit Create Request<br><br> The `Style Create` API is an HTTP `POST` request used to create an Azure Maps style by passing in either a JSON or ZIP file containing the style information. <br><br>The Create Style API is a [long-running operation](https://aka.ms/am-creator-lrt-v2).
      operationId: microsoftAzureStyleCreate
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-examples:
        Create Style by providing an azure maps style json file:
          $ref: ./examples/style/Style_Create.json
      consumes:
      - application/json
      - application/zip
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/DescriptionStyle'
      - $ref: '#/parameters/StyleAlias'
      - name: CreateContent
        in: body
        description: The style content to be uploaded. If JSON data format is provided, then the request body should follow [Layers specification](https://maplibre.org/maplibre-gl-js-docs/style-spec/layers) in MapLibre Style specification. If ZIP data format is provided, you should also provide the sprite sheet and associated index files which contains icons used in the style configuration json file.
        required: true
        schema:
          type: object
      responses:
        '202':
          $ref: ../../../Common/preview/1.0/common.json#/responses/202AsyncV2
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
    get:
      summary: Microsoft Azure Use To Get A List Of Styles
      description: <br><br>The `List` API is an HTTP `GET` request that allows the caller to fetch a list of all styles in the current Azure Maps Creator account. The default indoor style `microsoft-maps:indoor_2022-01-01` and `microsoft-maps:indoor_dark_2022-01-01` will not show in the list response. But you can still use it as your own style by the predefined alias.<br><br>### Submit List Request
      operationId: microsoftAzureStyleList
      x-ms-examples:
        Get a list of all styles:
          $ref: ./examples/style/Style_List.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      x-ms-pageable:
        itemName: styles
        nextLinkName: nextLink
      responses:
        '200':
          description: List style request completed successfully. The response body contains a list of all styles.
          schema:
            $ref: '#/definitions/StyleListResult'
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
  /styles/{styleId}:
    get:
      summary: Microsoft Azure Use To Get Details Of A Style
      description: <br><br>### Submit Get Request<br><br>The `Get` API is an HTTP `GET` request that allows the caller to fetch the details of an existing style by passing in the `styleId` or its [alias](). Get the two predefined default styles using the alias `microsoft-maps:indoor_2022-01-01` for indoor light and `microsoft-maps:indoor_dark_2022-01-01` for indoor dark.
      operationId: microsoftAzureStyleGet
      x-ms-examples:
        Get the details for a single style:
          $ref: ./examples/style/Style_Get.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/StyleId'
      produces:
      - application/zip
      responses:
        '200':
          description: Get style request completed successfully. The response body contains a zip file with style content.
          schema:
            type: object
            format: file
            readOnly: true
          headers:
            Content-Type:
              type: string
              description: The content-type for the response.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
    delete:
      summary: Microsoft Azure Use To Delete A Style
      description: '<br><br>### Submit Delete Request<br><br><br><br>The `Delete` API is an HTTP `DELETE` request that is used to delete the specified style, where the path will contain the `styleId` of the style to delete. <br><br>#### Delete request "Successful"<br><br>The Style Delete API returns a HTTP `204 No Content` response with an empty body, if the style was deleted successfully. <br><br>#### Delete request "Failed"<br><br>A HTTP `400 Bad Request` error response will be returned if the style with the passed-in `styleId` is not found. <br><br>Here is a sample error response:<br><br><br><br>```json<br>{<br>  "error": {<br>      "code": "400 BadRequest",<br>      "message": "Bad request - Style Id: d85b5b27-5fc4-4599-8b50-47160e90f8ce does not exist."<br>  }<br>}<br>```'
      operationId: microsoftAzureStyleDelete
      x-ms-examples:
        Delete a created style:
          $ref: ./examples/style/Style_Delete.json
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/StyleId'
      responses:
        '204':
          description: Style delete request completed successfully.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
  /styles/operations/{operationId}:
    get:
      summary: Microsoft Azure Use To Check The Status Of The Style Creation Process
      description: <br><br>The `Get Operation` API is an HTTP `GET` request used to check the status of the style creation process and retrieve the `styletId`.<br><br>### Submit Operations Request<br><br>To view the current progress of a style operation, you will use a `GET` request where the `operationId` given the path is the ID that represents the operation.<br><br>### Operation Response<br><br>While in progress, a `200-OK` http status code is returned with no extra headers. If the operation succeeds, a `200-OK` http status code is returned with the `Resource-Location` in the header.
      operationId: microsoftAzureStyleGetoperation
      x-ms-examples:
        Get the status of an operation which is still running:
          $ref: ./examples/style/Style_GetOperationStillRunning.json
        Get the status of an operation which has finished successfully:
          $ref: ./examples/style/Style_GetOperation.json
      parameters:
      - $ref: '#/parameters/ApiVersion'
      - $ref: '#/parameters/StyleOperationId'
      responses:
        '200':
          description: The operation is running or complete. If the operation was successful, use the Resource-Location header to obtain the path to the result.
          schema:
            $ref: ./tileset.json#/definitions/LongRunningOperationResult
          headers:
            Resource-Location:
              type: string
              description: If successful, a URI where details on the newly created resource can be found.
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
definitions:
  MapConfigurationListItem:
    description: One item in map configuration list.
    type: object
    properties:
      mapConfigurationId:
        description: The unique id for the map configuration.
        type: string
        readOnly: true
      description:
        description: The description the caller provided when creating the map configuration. Maximum length 1024 characters.
        type: string
        readOnly: true
      alias:
        description: The alias used for the map configuration. Maximum length 1024 characters. Alias cannot start with `microsoft-maps` which is a reserved prefix.
        type: string
        readOnly: true
      created:
        description: The creation date and time of this map configuration.
        type: string
        format: date-time
        readOnly: true
  ConfigurationObject:
    description: Define the format to configure a style picker and the associated map in client SDK.
    type: object
    required:
    - name
    - layers
    properties:
      name:
        description: The name for the style. Maximum length 255 characters.
        type: string
      displayName:
        description: The display name for the style picker in client SDK. Maximum length 255 characters.
        type: string
      description:
        description: The description for the style. Maximum length 500 characters.
        type: string
      theme:
        description: The theme for client SDK widgets(style picker, zoom, level picker).
        type: string
        enum:
        - light
        - dark
        x-ms-enum:
          name: theme
          modelAsString: true
          values:
          - value: light
            description: The light theme for client SDK widgets(style picker, zoom, level picker).
          - value: dark
            description: The dark theme for client SDK widgets(style picker, zoom, level picker).
      thumbnail:
        description: The thumbnail image file for the style picker in client SDK. Maximum length 255 characters. The size limit is 400KB and pixel limit is 512*512.
        type: string
      baseMap:
        description: The base map is a background layer for private indoor map. This property is optional, no base map will show if not provided. Maximum length 100 characters.
        $ref: '#/definitions/BaseMapType'
      layers:
        description: To configure the style for tileset. You can have one style for the whole tileset. And you can have different styles for different layers in one tileset, for example, one style for `indoor unit` layer and another style for `indoor facility` layer. And you have also have one style for different tileset
        items:
          $ref: '#/definitions/TilesetStyleTuple'
  BaseMapType:
    description: The available base map types. Currently, we support 9 base map types.
    type: string
    enum:
    - microsoft_light
    - microsoft_dark
    - microsoft_grayscale_light
    - microsoft_grayscale_dark
    - microsoft_high_contrast_light
    - microsoft_high_contrast_dark
    - microsoft_shaded_relief
    - microsoft_satellite
    - microsoft_satellite_road
    x-ms-enum:
      name: BaseMap
      modelAsString: true
      values:
      - value: microsoft_light
        description: The base road map style.
      - value: microsoft_dark
        description: The base dark road map style.
      - value: microsoft_grayscale_light
        description: The grayscale light map style.
      - value: microsoft_grayscale_dark
        description: The grayscale dark map style.
      - value: microsoft_high_contrast_light
        description: The high contrast light map style.
      - value: microsoft_high_contrast_dark
        description: The high contrast dark map style.
      - value: microsoft_shaded_relief
        description: The shaded relief map style.
      - value: microsoft_satellite
        description: The satellite imagery map style.
      - value: microsoft_satellite_road
        description: The satellite and road map style.
  TilesetStyleTuple:
    description: TilesetId and StyleId tuple
    type: object
    required:
    - tilesetId
    - styleId
    properties:
      tilesetId:
        description: The unique id of a tileset.
        type: string
      styleId:
        description: The unique id of an azure map style. Two predefined styleId aliases are `microsoft-maps:indoor_2022-01-01` for indoor light and `microsoft-maps:indoor_dark_2022-01-01` for indoor dark.
        type: string
  MapConfiguration:
    description: A map configuration object which describes the map configuration json format.
    type: object
    required:
    - version
    properties:
      version:
        description: The version of the map configuration, currently only version 1.0 is supported.
        type: number
        format: float
      description:
        description: The description the caller provided when creating the map configuration. Maximum length 1024 characters.
        type: string
      defaultConfiguration:
        description: The default configuration for the map configuration. The value should be one of the 'name' field in ConfigurationObject under 'configurations' array. If not provided, first entry in the 'configurations' list will be used.
        type: string
      configurations:
        description: '''Configurations'' array will allow customer to configure different map representations for their tileset. Each configuration configured here will be reflected as one map style in style picker in client SDK. The name should be unique in the configurations array.'
        items:
          $ref: '#/definitions/ConfigurationObject'
  MapConfigurationListResult:
    description: The response model for the Map Configuration List API. Returns a list of all map configurations.
    type: object
    properties:
      mapConfigurations:
        description: A list of all map configurations.
        type: array
        readOnly: true
        items:
          $ref: '#/definitions/MapConfigurationListItem'
      nextLink:
        description: If present, the location of the next page of data.
        type: string
        readOnly: true
  StyleListItem:
    description: Detail information for the data.
    type: object
    properties:
      styleId:
        description: The unique style id for the style.
        type: string
        readOnly: true
      description:
        description: The description the caller provided when creating the style. Maximum length 1024 characters.
        type: string
        readOnly: true
      alias:
        description: The alias of the style. Maximum length 1024 characters. Alias cannot start with `microsoft-maps` which is a reserved prefix.
        type: string
        readOnly: true
      created:
        description: The creation date and time of this style.
        type: string
        format: date-time
        readOnly: true
  StyleListResult:
    description: The response model for the Style List API. Returns a list of all styles.
    type: object
    properties:
      styles:
        description: A list of all styles.
        type: array
        readOnly: true
        items:
          $ref: '#/definitions/StyleListItem'
      nextLink:
        description: If present, the location of the next page of data.
        type: string
        readOnly: true
parameters:
  StyleId:
    name: styleId
    description: The Style Id.
    type: string
    in: path
    required: true
    x-ms-parameter-location: method
  DescriptionMapConfiguration:
    name: description
    description: User provided description of the map configuration. Maximum length 1024 characters.
    type: string
    in: query
    x-ms-parameter-location: method
  Alias:
    name: alias
    description: The alias of the map configuration. Maximum length 1024 characters. Alias cannot start with `microsoft-maps` which is a reserved prefix. Alias can be provided optionally during creating a map configuration, and can be used as same as mapConfigurationId after map configuration creation.
    type: string
    in: query
    required: false
    x-ms-parameter-location: method
  MapConfigurationOperationId:
    name: operationId
    type: string
    in: path
    description: The ID to query the status for the map configuration create request.
    required: true
    x-ms-parameter-location: method
  DescriptionStyle:
    name: description
    description: User provided description of the style. Maximum length 1024 characters.
    type: string
    in: query
    x-ms-parameter-location: method
  ApiVersion:
    name: api-version
    description: Version number of Azure Maps API.
    type: string
    in: query
    required: true
    x-ms-parameter-location: client
  StyleOperationId:
    name: operationId
    type: string
    in: path
    description: The ID to query the status for the style create request.
    required: true
    x-ms-parameter-location: method
  StyleAlias:
    name: alias
    description: 'The alias of the style. Maximum length 1024 characters. Alias cannot start with `microsoft-maps` which is a reserved prefix. Alias can be provided optionally during creating a style, and can be used as same as styleId after style creation. '
    type: string
    in: query
    required: false
    x-ms-parameter-location: method
  MapConfigurationId:
    name: mapConfigurationId
    description: The map configuration Id.
    type: string
    in: path
    required: true
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'
Microsoft Azure Styles API

Documentation

Specifications

Other Resources

OpenAPI Specification
