Compartir a través de

Azure Maps biblioteca cliente de representación del SDK para Java: versión 1.0.0-beta.2

  • Artículo

Azure Maps biblioteca cliente de representación del SDK para Java.

Este paquete contiene el SDK de Microsoft Azure para render management SDK que contiene Azure Maps RENDER API REST. Azure Maps Render recupera información de copyrigt o iconos de mapa o estado. Para obtener documentación sobre cómo usar este paquete, consulte Azure Maps Representación.

Código | fuenteDocumentación | de referencia de APIDocumentación | de la API RESTDocumentación | del productoMuestras

Documentación

Hay varias documentación disponibles para ayudarle a empezar

Introducción

Requisitos previos

Adición del paquete al producto

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

Azure Maps Bibliotecas requieren una TokenCredential implementación para la autenticación y una implementación para el HttpClient cliente HTTP.

El paquete de identidad de Azure y el paquete HTTP de Azure Core Netty proporcionan la implementación predeterminada.

Authentication

De forma predeterminada, la autenticación de tokens de Azure Active Directory depende de la configuración correcta de las siguientes variables de entorno.

  • AZURE_CLIENT_ID para el identificador de cliente de Azure.
  • AZURE_TENANT_ID para el identificador de inquilino de Azure.
  • AZURE_CLIENT_SECRET o AZURE_CLIENT_CERTIFICATE_PATH para el secreto de cliente o el certificado de cliente.

Además, el identificador de suscripción de Azure se puede configurar mediante la variable AZURE_SUBSCRIPTION_IDde entorno .

Con la configuración anterior, azure el cliente se puede autenticar mediante el código siguiente:

// 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();

En el código de ejemplo se supone que Azure global. AzureEnvironment.AZURE Cambie la variable si lo contrario.

Consulte Autenticación para obtener más opciones.

Conceptos clave

Consulte Diseño de API para obtener una introducción general sobre el diseño y los conceptos clave en las bibliotecas de administración de Azure.

Ejemplos

Obtener icono del 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);

Obtener conjunto de iconos de mapa

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

Obtener atribución 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);

Obtener título de copyright

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

Obtener imagen estática de 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();

Obtener derechos de autor del rectángulo delimitador

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

Obtener derechos de autor para el icono

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

Obtener derechos de autor para el mundo

client.getCopyrightForWorld(true);

Solución de problemas

Al interactuar con los servicios de Azure Maps, los errores devueltos por el servicio Maps corresponden a los mismos códigos de estado HTTP devueltos para las solicitudes de LA API REST.

Por ejemplo, si busca con una coordenada no válida, se devuelve un error, que indica "Solicitud incorrecta".400

Pasos siguientes

Hay varios ejemplos de SDK de Java de representación Azure Maps disponibles en el repositorio de GitHub del SDK. ejemplos de representación de Azure Maps

Contribuciones

Para más información sobre cómo contribuir a este repositorio, consulte la guía de contribución.

  1. Bifurcación
  2. Creación de la rama de características (git checkout -b my-new-feature)
  3. Confirmar los cambios (git commit -am 'Add some feature')
  4. Inserción en la rama (git push origin my-new-feature)
  5. Creación de una nueva solicitud de incorporación de cambios

Impresiones