Conversion

Operations

Convert

Applies to: see pricing tiers.

Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. This article introduces concepts and tools that apply to Azure Maps Creator.

The Conversion API lets the caller import a set of DWG design files as a zipped Drawing Package into Azure Maps. The Drawing Package should first be uploaded using the Azure Maps Data Service. Once uploaded, use the udid returned by the Data Upload API to call this Conversion API.

Convert DWG package

The Conversion API performs a long-running request.

Debug DWG package issues

During the Conversion process, if there are any issues with the DWG package errors and warnings are provided in the response along with a diagnostic package to visualize and diagnose these issues. In case any issues are encountered with your DWG package, the Conversion operation status process as detailed here returns the location of the diagnostic package that can be downloaded by the caller to help them visualize and diagnose these issues. The diagnostic package location can be found in the properties section of the conversion operation status response and looks like the following:

{
    "properties": {
        "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapdata/{DiagnosticPackageId}?api-version=1.0"                
    }            
}

The diagnostic package can be downloaded by executing a HTTP GET request on the diagnosticPackageLocation. For more details on how to use the tool to visualize and diagnose all the errors and warnings see Drawing Error Visualizer.

A conversion operation will be marked as success if there are zero or more warnings but will be marked as failed if any errors are encountered.

Delete

Applies to: see pricing tiers.

Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. This article introduces concepts and tools that apply to Azure Maps Creator.

This API allows the caller to delete any data conversions created previously using the Conversion API.

Submit Delete Request

To delete your conversion data you will issue a DELETE request where the path will contain the conversionId of the data to delete.

Conversion Delete Response

The Conversion Delete API returns a HTTP 204 No Content response with an empty body, if the converted data resources were deleted successfully.

A HTTP 400 Bad Request error response will be returned if no resource associated with the passed-in conversionId is found.

Get

Applies to: see pricing tiers.

Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. This article introduces concepts and tools that apply to Azure Maps Creator.

This API allows the caller to fetch a successful data conversion submitted previously using the Conversion API.

Get Operation

This path will be obtained from a call to POST /conversions. While in progress, an http200 will be returned with no extra headers - followed by an http200 with Resource-Location header once successfully completed.

List

Applies to: see pricing tiers.

Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. This article introduces concepts and tools that apply to Azure Maps Creator.

This API allows the caller to fetch a list of all successful data conversions submitted previously using the Conversion API.

Submit List Request

To list all successful conversions you will issue a GET request with no additional parameters.

List Data Response

The Conversion List API returns the complete list of all conversion details in json format.

Here is a sample response returning the details of two successful conversion requests:


{
    "conversions": 
    [
        {
            "conversionId": "54398242-ea6c-1f31-4fa6-79b1ae0fc24d",
            "udid": "31838736-8b84-11ea-bc55-0242ac130003",
            "created": "5/19/2020 9:00:00 AM +00:00",
            "description": "User provided description.",
            "featureCounts": {
                "DIR": 1,
                "LVL": 3,
                "FCL": 1,
                "UNIT": 150,
                "CTG": 8,
                "AEL": 0,
                "OPN": 10
            }
        },
        {
            "conversionId": "2acf7d32-8b84-11ea-bc55-0242ac130003",
            "udid": "1214bc58-8b84-11ea-bc55-0242ac1300039",
            "created": "5/19/2020 9:00:00 AM +00:00",
            "description": "User provided description.",
            "featureCounts": {
                "DIR": 1,
                "LVL": 3,
                "FCL": 1,
                "UNIT": 150,
                "CTG": 8,
                "AEL": 0,
                "OPN": 10
            }
        }
    ]
}