Azure Maps SDK Render client library for Java - バージョン 1.0.0-beta.2
Azure Maps SDK Render client library for Java。
このパッケージには、Render REST API を含む Microsoft Azure SDK for Render Management SDK Azure Maps含まれています。 Azure Maps Render は、コピーリグ情報またはマップ/状態タイルを取得します。 このパッケージの使用方法に関するドキュメントについては、「Azure Maps Render」を参照してください。
ソースコード | API リファレンス ドキュメント | REST API のドキュメント | 製品ドキュメント | サンプル
ドキュメント
作業の開始に役立つさまざまなドキュメントが用意されています
作業の開始
前提条件
- バージョン 8 以降の Java Development Kit (JDK)
- Azure サブスクリプション
製品へのパッケージの追加
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-maps-render</artifactId>
<version>1.0.0-beta.2</version>
</dependency>
推奨されるパッケージを含める
Azure Maps ライブラリでは、認証のTokenCredential実装と HTTP クライアントの実装がHttpClient必要です。
Azure Identity パッケージと Azure Core Netty HTTP パッケージは、既定の実装を提供します。
認証
既定では、Azure Active Directory トークン認証は、次の環境変数の正しい構成に依存します。
AZURE_CLIENT_IDAzure クライアント ID の場合。AZURE_TENANT_IDAzure テナント ID の場合。AZURE_CLIENT_SECRETクライアント シークレットまたはAZURE_CLIENT_CERTIFICATE_PATHクライアント証明書の場合は 。
さらに、Azure サブスクリプション ID は環境変数 AZURE_SUBSCRIPTION_IDを使用して構成できます。
上記の構成では、 azure 次のコードを使用してクライアントを認証できます。
// 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();
サンプル コードでは、グローバル Azure を前提としています。 それ以外の場合は変数を変更 AzureEnvironment.AZURE してください。
その他のオプションについては、「 認証」 を参照してください。
主要な概念
Azure 管理ライブラリの設計と主要な概念の一般的な概要については、 API の設計に関するページを参照してください。
例
Get Map Tile
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);
マップ タイルセットを取得する
System.out.println("Get Map Tileset");
new TilesetId();
client.getMapTileset(TilesetId.MICROSOFT_BASE);
マップ属性の取得
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);
著作権キャプションを取得する
System.out.println("Get Copyright Caption");
client.getCopyrightCaption();
マップの静的イメージを取得する
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();
境界ボックスから著作権を取得する
GeoBoundingBox boundingBox = new GeoBoundingBox(52.41064, 4.84228, 52.41072, 4.84239);
client.getCopyrightFromBoundingBox(boundingBox, true);
タイルの著作権を取得する
client.getCopyrightForTile(new TileIndex().setX(9).setY(22).setZ(6), true);
世界の著作権を取得する
client.getCopyrightForWorld(true);
トラブルシューティング
Azure Maps Services と対話すると、Maps サービスによって返されるエラーは、REST API 要求に対して返されるのと同じ HTTP 状態コードに対応します。
たとえば、無効な座標で検索すると、"Bad Request"を示すエラーが返されます。400
次の手順
いくつかの Azure Maps Render Java SDK サンプルは、SDK の GitHub リポジトリで入手できます。 Azure Maps レンダー サンプル
共同作成
このリポジトリへの投稿の詳細については、 投稿ガイドを参照してください。
- フォークする
- 機能ブランチを作成する (
git checkout -b my-new-feature) - 変更をコミットする (
git commit -am 'Add some feature') - ブランチにプッシュする (
git push origin my-new-feature) - 新しい Pull Request を作成する
Azure SDK for Java