Azure Mapas biblioteca de clientes de Elevação do SDK para Java – versão 1.0.0-beta.2

Artigo
09/21/2023

(Preterido)

Azure Mapas biblioteca de clientes de Elevação do SDK para Java.

Esse pacote contém a biblioteca de clientes de elevação do SDK Azure Mapas que contém APIs de elevação de Azure Mapas. Para obter a documentação sobre como usar esse pacote, consulte Azure Mapas APIs REST de elevação.

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

Importante

Observe que esse pacote foi preterido e não estará mais em serviço ou será mantido após 5 de maio de 2023. Todas as outras APIs Azure Mapas, Serviços e TilesetIDs não são afetadas por essa desativação. Consulte o guia de migração Desativação dos Serviços de Elevação para obter diretrizes sobre atualização. Consulte nossa política de substituição (https://aka.ms/azsdk/support-policies) para obter mais detalhes.

Documentação

Várias documentações estão disponíveis para ajudá-lo a começar

Documentação de referência da API

Introdução

Pré-requisitos

JDK (Java Development Kit) com a versão 8 ou superior
Assinatura do Azure

Adicionando o pacote ao seu produto

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-maps-elevation</artifactId>
    <version>1.0.0-beta.2</version>
</dependency>

Incluir os pacotes recomendados

As Bibliotecas de Gerenciamento do Azure exigem uma TokenCredential implementação para autenticação e uma HttpClient implementação para o cliente HTTP.

O pacote de Identidade do Azure e o pacote HTTP do Azure Core Netty fornecem a implementação padrão.

Autenticação

Por padrão, a autenticação de token do Azure Active Directory depende da configuração correta das variáveis de ambiente a seguir.

AZURE_CLIENT_ID para a ID do cliente do Azure.
AZURE_TENANT_ID para a ID do locatário do Azure.
AZURE_CLIENT_SECRET ou AZURE_CLIENT_CERTIFICATE_PATH para o segredo do cliente ou certificado do cliente.

Além disso, a ID da assinatura do Azure pode ser configurada por meio da variável AZURE_SUBSCRIPTION_IDde ambiente .

Com a configuração acima, azure o cliente pode ser autenticado seguindo o código:

// Authenticates using Azure AD building a default credential
// This will look for AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_CLIENT_SECRET env variables
DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();

// Creates a client
ElevationClient client = new ElevationClientBuilder()
    .credential(tokenCredential)
    .elevationClientId(System.getenv("MAPS_CLIENT_ID"))
    .buildClient();

O código de exemplo pressupõe o Azure global. Altere a AzureEnvironment.AZURE variável, caso contrário.

Confira Autenticação para obter mais opções.

Principais conceitos

Consulte Design de API para obter introdução geral sobre design e conceitos principais nas Bibliotecas de Gerenciamento do Azure.

Exemplos

Obter dados para pontos

client.getDataForPoints(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.68853362143818, 46.856464798637127)));

Obter dados para polilinha

client.getDataForPolyline(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.65853362143818, 46.85646479863713)), 5);

Obter dados para a caixa delimitadora

client.getDataForBoundingBox(new GeoBoundingBox(-121.668533621438, 46.8464647986371,
    -121.658533621438, 46.8564647986371), 3, 3);

Solução de problemas

Quando você interage com os Serviços de Azure Mapas, os erros retornados pelo serviço Mapas correspondem aos mesmos códigos http status retornados para solicitações de API REST.

Por exemplo, se você pesquisar com uma coordenada inválida, um erro será retornado, indicando "Solicitação Incorreta".400

Próximas etapas

Várias Azure Mapas exemplos de SDK do Java de Elevação estão disponíveis para você no repositório GitHub do SDK. exemplos de elevação Azure Mapas

Participante

Para obter detalhes sobre como contribuir para esse repositório, consulte o guia de contribuição.

Bifurcar
Criar seu branch de recurso (git checkout -b my-new-feature)
Confirmar suas alterações (git commit -am 'Add some feature')
Enviar por push para o branch (git push origin my-new-feature)
Criar nova solicitação de pull

Impressões

Partilhar via