Microsoft Azure Styles API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Styles API
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
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/Alias'
      - $ref: '#/components/parameters/DescriptionMapConfiguration'
      responses:
        '202':
          $ref: ../../../Common/preview/1.0/common.json#/responses/202AsyncV2
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MapConfiguration'
          application/zip:
            schema:
              $ref: '#/components/schemas/MapConfiguration'
        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
    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: '#/components/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.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/MapConfigurationId'
      responses:
        '200':
          description: Get map configuration request completed successfully. The response body contains a single map configuration zip file.
          headers:
            Content-Type:
              description: The content-type for the response.
              schema:
                type: string
          content:
            application/zip:
              schema:
                type: object
                format: file
                readOnly: true
        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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/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.
          headers:
            Resource-Location:
              description: If successful, a URI where details on the newly created resource can be found.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: ./tileset.json#/definitions/LongRunningOperationResult
        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
      parameters:
      - $ref: ../../../Common/preview/1.0/common.json#/parameters/ClientId
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/DescriptionStyle'
      - $ref: '#/components/parameters/StyleAlias'
      responses:
        '202':
          $ref: ../../../Common/preview/1.0/common.json#/responses/202AsyncV2
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
      requestBody:
        content:
          application/json:
            schema:
              type: object
          application/zip:
            schema:
              type: object
        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
    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: '#/components/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.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/StyleId'
      responses:
        '200':
          description: Get style request completed successfully. The response body contains a zip file with style content.
          headers:
            Content-Type:
              description: The content-type for the response.
              schema:
                type: string
          content:
            application/zip:
              schema:
                type: object
                format: file
                readOnly: true
        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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/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: '#/components/parameters/ApiVersion'
      - $ref: '#/components/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.
          headers:
            Resource-Location:
              description: If successful, a URI where details on the newly created resource can be found.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: ./tileset.json#/definitions/LongRunningOperationResult
        default:
          $ref: ../../../Common/preview/1.0/common.json#/responses/default
      tags:
      - Styles
components:
  parameters:
    StyleId:
      name: styleId
      description: The Style Id.
      in: path
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
    DescriptionMapConfiguration:
      name: description
      description: User provided description of the map configuration. Maximum length 1024 characters.
      in: query
      x-ms-parameter-location: method
      schema:
        type: string
    MapConfigurationOperationId:
      name: operationId
      in: path
      description: The ID to query the status for the map configuration create request.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
    MapConfigurationId:
      name: mapConfigurationId
      description: The map configuration Id.
      in: path
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
    DescriptionStyle:
      name: description
      description: User provided description of the style. Maximum length 1024 characters.
      in: query
      x-ms-parameter-location: method
      schema:
        type: string
    StyleOperationId:
      name: operationId
      in: path
      description: The ID to query the status for the style create request.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
    ApiVersion:
      name: api-version
      description: Version number of Azure Maps API.
      in: query
      required: true
      x-ms-parameter-location: client
      schema:
        type: string
    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.
      in: query
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    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. '
      in: query
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
  schemas:
    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
    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
    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.
    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
    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: '#/components/schemas/MapConfigurationListItem'
        nextLink:
          description: If present, the location of the next page of data.
          type: string
          readOnly: true
    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: '#/components/schemas/ConfigurationObject'
    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: '#/components/schemas/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: '#/components/schemas/TilesetStyleTuple'
    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: '#/components/schemas/StyleListItem'
        nextLink:
          description: If present, the location of the next page of data.
          type: string
          readOnly: true
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'