Azure Mapas biblioteca de clientes comuns para .NET – versão 1.0.0-beta.4

Artigo
07/20/2023

Azure Mapas é um serviço gerenciado pela Microsoft que fornece um serviço de mapas que é...

A biblioteca Azure.Maps.Common fornece infraestrutura compartilhada entre outras bibliotecas de cliente Azure Mapas.

Código-fonte | Documentação | de referência da API Documentação do produto

Introdução

Instalar o pacote

Instale a biblioteca de clientes Azure Mapas para .NET que você gostaria de usar com o NuGet e a Azure.Maps.Common biblioteca de clientes será incluída. Escolha os pacotes que você deseja instalar:

dotnet add package Azure.Maps.Search --prerelease
dotnet add package Azure.Maps.Routing --prerelease
dotnet add package Azure.Maps.Rendering --prerelease
dotnet add package Azure.Maps.Geolocation --prerelease

Pré-requisitos

Você deve ter uma assinatura do Azure e uma conta Azure Mapas.

Para criar uma nova conta Azure Mapas, você pode usar o Portal do Azure, Azure PowerShell ou a CLI do Azure. Aqui, está um exemplo usando a CLI do Azure:

az maps account create --kind "Gen2" --account-name "myMapAccountName" --resource-group "<resource group>" --sku "G2"

Autenticar o cliente

Há duas maneiras de autenticar o cliente: autenticação de chave compartilhada e Azure AD. Consulte outros pacotes de Azure Mapas para obter uma descrição detalhada.

Principais conceitos

A biblioteca de clientes Azure Mapas Comum contém infraestrutura compartilhada, como LocalizedMapView e RequestFailedException.

Acesso thread-safe

Garantimos que todos os métodos de instância do cliente sejam thread-safe e independentes uns dos outros (diretriz). Isso garante que a recomendação de reutilize instâncias de cliente seja sempre segura, mesmo entre threads.

Conceitos adicionais

Exemplos

Confira os exemplos de Pesquisa, Roteamento, Renderização e Geolocalização.

Solução de problemas

Se criar uma instância de um nullLocalizedMapView, o programa gerará um ArgumentNullException erro.

Próximas etapas

Comece com nossos exemplos de Pesquisa, Roteamento, Renderização e Geolocalização .

Participante

Consulte o CONTRIBUTING.md para obter detalhes sobre como criar, testar e contribuir para essa biblioteca.

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite <cla.microsoft.com>.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Impressões