AzureMapsControl.Components 1.12.0-alpha0038

This is a prerelease version of AzureMapsControl.Components.
There is a newer version of this package available.
See the version list below for details.
dotnet add package AzureMapsControl.Components --version 1.12.0-alpha0038
                    
NuGet\Install-Package AzureMapsControl.Components -Version 1.12.0-alpha0038
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AzureMapsControl.Components" Version="1.12.0-alpha0038" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="AzureMapsControl.Components" Version="1.12.0-alpha0038" />
                    
Directory.Packages.props
<PackageReference Include="AzureMapsControl.Components" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add AzureMapsControl.Components --version 1.12.0-alpha0038
                    
#r "nuget: AzureMapsControl.Components, 1.12.0-alpha0038"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package AzureMapsControl.Components@1.12.0-alpha0038
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=AzureMapsControl.Components&version=1.12.0-alpha0038&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=AzureMapsControl.Components&version=1.12.0-alpha0038&prerelease
                    
Install as a Cake Tool

Nuget Nuget (with prereleases) Build Unit Test release codecov Slack

This library allows you to use Azure Maps inside your razor application.

Custom Azure Map

Install the Nuget Package

This library is available on Nuget as AzureMapsControl.Components.

Setup

Add the css and scripts

You will need to add the atlas script and css files as well as the script generated by the library on your application.

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>
<script src="_content/AzureMapsControl.Components/azure-maps-control.js"></script>

Or use the minimized version :

<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>
<script src="_content/AzureMapsControl.Components/azure-maps-control.min.js"></script>

Register the Components

You will need to pass the authentication information of your AzureMaps instance to the library. SubscriptionKey, Aad and Anonymous authentication are supported. You will need to call the AddAzureMapsControl method on your services.

You can authenticate using a subscription key :

    // This method gets called by the runtime. Use this method to add services to the container.
    // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddRazorPages();
        services.AddServerSideBlazor();
        
        services.AddAzureMapsControl(configuration => configuration.SubscriptionKey = "Your Subscription Key");
    }

Or using Azure Active Directory:

public void ConfigureServices(IServiceCollection services)
        {
            services.AddRazorPages();
            services.AddServerSideBlazor(options => options.DetailedErrors = true);

            services.AddAzureMapsControl(configuration => {
                configuration.AadAppId = "Your Aad App Id";
                configuration.AadTenant = "Your Aad Tenant";
                configuration.ClientId = "Your Client Id";
            });
        }

The Anonymous authentication requires only a ClientId:

public void ConfigureServices(IServiceCollection services)
        {
            services.AddRazorPages();
            services.AddServerSideBlazor(options => options.DetailedErrors = true);

            services.AddAzureMapsControl(configuration => configuration.ClientId = Configuration["AzureMaps:ClientId"])
        }

It also needs to fetch the token to send to the requests of the atlas library. For that, you have to override the azureMapsControl.Extensions.getTokenCallback method on your application after referencing azure-maps-control.min.js and resolve the token in it. For example :

@page "/"
@namespace AzureMapsControl.Sample.Pages
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
@{
    Layout = null;
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>AzureMapsControl.Sample</title>
    <base href="~/" />
    <link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
    <link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/drawing/0.1/atlas-drawing.min.css" type="text/css" />
    <style>
        body {
            margin: 0;
        }

        #map {
            position: absolute;
            width: 100%;
            min-width: 290px;
            height: 100%;
        }
    </style>
</head>
<body>
    <app>
        <component type="typeof(App)" render-mode="ServerPrerendered" />
    </app>
    <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>
    <script src="https://atlas.microsoft.com/sdk/javascript/drawing/0.1/atlas-drawing.min.js"></script>
    <script src="_content/AzureMapsControl.Components/azure-maps-control.min.js"></script>
    <script src="_framework/blazor.server.js"></script>
    <script type="text/javascript">
        azureMapsControl.Extensions.getTokenCallback = (resolve, reject, map) => {
            const url = "url_of_my_token_endpoint";
            fetch(url).then(function (response) {
                return response.text();
            }).then(function (token) {
                resolve(token);
            });        
        };
    </script>
</body>
</html>

How to use

Want to contribute ?

Contributions are welcome! One of the best way to start is to take a look at the list of issues where help is wanted.

If you need a new feature which is not listed on the issues, feel free to open a new one. Take also a look at the Contributing guidelines.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.0-net9.10 229 12/19/2024
2.0.0-net9.9 64 12/19/2024
2.0.0-net9.8 67 12/19/2024
2.0.0-net9.7 72 12/19/2024
2.0.0-net9.6 67 12/18/2024
2.0.0-net9.5 63 12/18/2024
2.0.0-net9.4 71 12/18/2024
2.0.0-net9.3 69 12/18/2024
2.0.0-net9.2 84 12/18/2024
1.17.0 963 10/9/2025
1.16.1 30,523 6/18/2024
1.16.0 594 6/14/2024
1.16.0-alpha0003 150 6/14/2024
1.16.0-alpha0001 439 3/27/2024
1.15.0 6,773 3/12/2024
1.15.0-alpha0002 159 3/12/2024
1.14.1 558 2/28/2024
1.14.0 1,121 12/22/2023
1.14.0-alpha0015 170 12/22/2023
1.13.0 26,765 9/14/2022
1.13.0-alpha0001 359 9/13/2022
1.12.0 3,262 8/3/2022
1.12.0-alpha0038 297 8/3/2022
1.12.0-alpha0028 343 7/8/2022
1.12.0-alpha0019 279 7/7/2022
1.12.0-alpha0011 311 6/14/2022
1.12.0-alpha0004 394 2/2/2022
1.12.0-alpha0003 346 2/2/2022
1.11.0 9,671 11/12/2021
1.11.0-alpha0015 385 11/12/2021
1.10.0 509 11/8/2021
1.10.0-net60-alpha0001 291 10/19/2021
1.10.0-alpha0010 363 11/8/2021
1.9.0 1,506 8/4/2021
1.9.0-alpha0006 455 8/4/2021
1.8.3 1,156 7/14/2021
1.8.3-beta0001 409 7/14/2021
1.8.2 587 7/13/2021
1.8.2-beta0001 449 7/13/2021
1.8.1 702 6/25/2021
1.8.1-beta0001 460 6/25/2021
1.8.0 558 6/19/2021
1.8.0-html-marker-laye0001 433 6/8/2021
1.8.0-alpha0003 451 6/19/2021
1.7.1 697 6/8/2021
1.7.1-beta0001 431 6/3/2021
1.7.0 655 5/31/2021
1.7.0-alpha0014 447 5/31/2021
1.7.0-alpha0004 407 5/18/2021
1.7.0-alpha0001 404 5/13/2021
1.6.1 728 5/18/2021
1.6.1-beta0001 417 5/18/2021
1.6.0 594 5/7/2021
1.6.0-alpha0050 471 5/7/2021
1.6.0-alpha0031 468 5/7/2021
1.6.0-alpha0015 443 5/7/2021
1.5.2 566 5/6/2021
1.5.2-beta0001 461 5/6/2021
1.5.1 813 4/30/2021
1.5.1-beta0001 408 4/30/2021
1.5.0 579 4/26/2021
1.5.0-alpha0016 424 4/23/2021
1.4.0 549 4/23/2021
1.4.0-alpha0005 426 4/20/2021
1.3.0 624 4/19/2021
1.3.0-beta0003 479 4/17/2021
1.3.0-beta0002 431 4/17/2021
1.3.0-beta0001 437 4/17/2021
1.3.0-alpha0001 418 4/16/2021
1.2.0 538 4/15/2021
1.2.0-alpha0004 400 4/15/2021
1.1.0 617 4/13/2021
1.1.0-alpha0015 392 4/13/2021
1.0.0 648 4/9/2021
1.0.0-beta0008 431 3/26/2021
1.0.0-beta0007 427 3/24/2021
1.0.0-beta0006 451 3/23/2021
1.0.0-beta0005 435 3/22/2021
1.0.0-beta0004 465 3/19/2021
1.0.0-beta0003 444 3/19/2021
1.0.0-beta0002 447 3/19/2021
1.0.0-beta0001 427 3/19/2021
0.17.1 532 4/6/2021
0.17.1-beta0001 403 4/5/2021
0.17.0 591 3/24/2021
0.16.0 580 3/23/2021
0.15.0 776 3/8/2021
0.15.0-alpha0038 459 3/8/2021
0.14.0 581 3/5/2021
0.14.0-alpha0003 417 3/5/2021
0.13.0 594 3/3/2021
0.13.0-alpha0001 437 3/3/2021
0.12.0 667 2/18/2021
0.12.0-typescript0001 440 2/18/2021
0.12.0-publish-typescri0001 443 2/18/2021
0.12.0-alpha0018 445 2/18/2021
0.11.0 576 2/17/2021
0.11.0-alpha0003 408 2/17/2021
0.10.1 581 2/15/2021
0.10.0 544 2/15/2021
0.10.0-alpha0011 404 2/15/2021
0.10.0-alpha0005 410 2/15/2021
0.9.0 614 1/24/2021
0.9.0-alpha0013 505 1/24/2021
0.9.0-alpha0006 506 1/3/2021
0.9.0-alpha0003 472 12/8/2020
0.8.1 630 1/3/2021
0.8.0 707 12/8/2020
0.8.0-beta0001 446 12/8/2020
0.8.0-alpha0005 486 11/25/2020
0.7.1 645 11/25/2020
0.7.0 658 11/25/2020
0.7.0-beta0001 495 11/25/2020
0.7.0-alpha0002 464 11/24/2020
0.6.0-beta0001 501 11/24/2020
0.6.0-alpha0005 487 11/24/2020
0.6.0-alpha0001 474 11/23/2020
0.5.2 1,868 11/24/2020
0.5.1 614 11/23/2020
0.5.0 604 11/19/2020
0.4.0 602 11/12/2020
0.3.0-beta0001 535 11/12/2020
0.3.0-alpha0019 450 11/19/2020
0.3.0-alpha0010 486 11/12/2020
0.3.0-alpha0004 527 11/12/2020
0.2.0 614 11/12/2020
0.2.0-beta0003 554 11/12/2020
0.2.0-beta0002 518 11/12/2020
0.2.0-beta0001 500 11/11/2020
0.1.0 701 11/11/2020
0.1.0-beta0002 512 11/11/2020
0.1.0-beta0001 508 11/11/2020
0.1.0-alpha0236 535 11/11/2020
0.1.0-alpha0116 492 11/11/2020
0.1.0-alpha0112 512 11/11/2020
0.1.0-alpha0097 505 11/11/2020
0.1.0-alpha0091 525 11/11/2020
0.1.0-alpha0090 542 11/10/2020
0.1.0-alpha0089 516 11/10/2020
0.1.0-alpha0088 537 11/10/2020
0.1.0-alpha0087 534 11/10/2020
0.1.0-alpha0086 526 11/10/2020
0.1.0-alpha0085 534 11/10/2020
0.1.0-alpha0084 532 11/10/2020
0.1.0-alpha0083 520 11/10/2020
0.1.0-alpha0082 568 11/9/2020
0.1.0-alpha0081 583 11/9/2020
0.1.0-alpha0080 567 11/9/2020
0.1.0-alpha0079 534 11/7/2020
0.1.0-alpha0077 739 11/6/2020
0.1.0-alpha0076 675 11/6/2020
0.1.0-alpha0074 603 11/6/2020
0.1.0-alpha0071 549 11/6/2020
0.0.1-ci-20201106.2 460 11/6/2020
0.0.1-ci-20201106.1 389 11/6/2020
0.0.1-ci-20201105.7 433 11/5/2020
0.0.1-ci-20201105.6 439 11/5/2020
0.0.1-ci-20201105.5 446 11/5/2020
0.0.1-ci-20201105.4 438 11/5/2020
0.0.1-ci-20201105.3 412 11/5/2020
0.0.1-ci-20201105.2 393 11/5/2020
0.0.1-ci-20201105.1 382 11/5/2020
0.0.1-ci-20201104.2 391 11/4/2020
0.0.1-ci-20201104.1 398 11/4/2020
0.0.1-ci-20201030.5 392 10/30/2020
0.0.1-ci-20201030.4 402 10/30/2020
0.0.1-ci-20201030.3 417 10/30/2020
0.0.1-ci-20201030.2 428 10/30/2020
0.0.1-ci-20201030.1 410 10/30/2020
0.0.1-ci-20201029.3 394 10/29/2020
0.0.1-ci-20201029.2 431 10/29/2020
0.0.1-ci-20201029.1 396 10/29/2020
0.0.1-ci-20201028.1 377 10/28/2020
0.0.1-ci-20201027.1 391 10/27/2020
0.0.1-ci-20201026.2 427 10/26/2020
0.0.1-ci-20201026.1 375 10/26/2020
0.0.1-ci-20201023.2 424 10/23/2020
0.0.1-ci-20201023.1 404 10/23/2020
0.0.1-ci-20201022.1 394 10/22/2020
0.0.1-ci-20201008.1 383 10/8/2020
0.0.1-ci-20201005.1 457 10/5/2020
0.0.1-ci-20200407.1 451 4/7/2020
0.0.1-ci-20200406.3 464 4/6/2020
0.0.1-ci-20200406.2 450 4/6/2020
0.0.1-ci-20200406.1 452 4/6/2020
0.0.1-ci-20200403.5 471 4/3/2020
0.0.1-ci-20200403.4 454 4/3/2020
0.0.1-ci-20200403.3 462 4/3/2020
0.0.1-ci-20200403.2 445 4/3/2020
0.0.1-ci-20200403.1 460 4/3/2020
0.0.1-ci-20200402.2 453 4/2/2020
0.0.1-ci-20200402.1 477 4/2/2020