Compartilhar via

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

  • Artigo

Azure Mapas biblioteca de clientes do SDK Renderizar para Java.

Esse pacote contém o SDK do Microsoft Azure para o SDK de Gerenciamento de Renderização que contém Azure Mapas APIs REST de Renderização. Azure Mapas Render recupera informações de copyrigt ou blocos de mapa/estado. Para obter a documentação sobre como usar esse pacote, consulte Azure Mapas Renderizar.

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

Documentação

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

Introdução

Pré-requisitos

Adicionando o pacote ao seu produto

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

Azure Mapas Bibliotecas 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 pelo seguinte 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 builder
MapsRenderClientBuilder builder = new MapsRenderClientBuilder();
builder.credential(tokenCredential);
builder.mapsClientId(System.getenv("MAPS_CLIENT_ID"));
builder.httpLogOptions(new HttpLogOptions().setLogLevel(HttpLogDetailLevel.BODY_AND_HEADERS));

// Builds a client
MapsRenderClient client = builder.buildClient();

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

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

Principais conceitos

Confira Design de API para obter introdução geral sobre design e principais conceitos sobre bibliotecas de gerenciamento do Azure.

Exemplos

Obter Peça de Mapa

System.out.println("Get Map Tile");
MapTileOptions mapTileOptions = new MapTileOptions();
mapTileOptions.setTilesetId(TilesetId.MICROSOFT_BASE_ROAD);
mapTileOptions.setTileIndex(new TileIndex().setX(10).setY(22).setZ(6));
client.getMapTile(mapTileOptions);

Obter conjunto de peças de mapa

System.out.println("Get Map Tileset");
new TilesetId();
client.getMapTileset(TilesetId.MICROSOFT_BASE);

Obter atribuição de mapa

System.out.println("Get Map Attribution");
GeoBoundingBox bounds = new GeoBoundingBox(-122.414162, 47.57949, -122.247157, 47.668372);
new TilesetId();
client.getMapAttribution(TilesetId.MICROSOFT_BASE, 6, bounds);

Obter legenda de direitos autorais

System.out.println("Get Copyright Caption");
client.getCopyrightCaption();

Obter imagem estática do mapa

System.out.println("Get Map Static Image");
GeoBoundingBox bbox = new GeoBoundingBox(1.355233, 42.982261, 24.980233, 56.526017);
new StaticMapLayer();
new RasterTileFormat();
MapStaticImageOptions mapStaticImageOptions = new MapStaticImageOptions().setStaticMapLayer(StaticMapLayer.BASIC)
    .setMapImageStyle(MapImageStyle.MAIN).setZoom(2)
    .setBoundingBox(bbox).setRasterTileFormat(RasterTileFormat.PNG);
client.getMapStaticImage(mapStaticImageOptions).toStream();

Obter direitos autorais da caixa delimitadora

GeoBoundingBox boundingBox = new GeoBoundingBox(52.41064, 4.84228, 52.41072, 4.84239);
client.getCopyrightFromBoundingBox(boundingBox, true);

Obter direitos autorais para bloco

client.getCopyrightForTile(new TileIndex().setX(9).setY(22).setZ(6), true);

Obter direitos autorais para o mundo

client.getCopyrightForWorld(true);

Solução de problemas

Quando você interage com os Serviços Azure Mapas, os erros retornados pelo serviço Mapas correspondem aos mesmos códigos http status retornados para solicitações da 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 renderizar exemplos do SDK do Java estão disponíveis para você no repositório GitHub do SDK. Azure Mapas renderizar exemplos

Participante

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

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

Impressões