次の方法で共有

java 用 Azure Maps SDK Elevation クライアント ライブラリ - バージョン 1.0.0-beta.2

  • [アーティクル]

(非推奨)

Java 用 SDK 昇格クライアント ライブラリをAzure Mapsします。

このパッケージには、Azure Maps Elevation API を含む Azure Maps SDK Elevation クライアント ライブラリが含まれています。 このパッケージの使用方法に関するドキュメントについては、「Azure Maps Elevation REST API」を参照してください。

ソースコード | API リファレンス ドキュメント | REST API のドキュメント | 製品ドキュメント | サンプル

重要

このパッケージは非推奨となり、2023 年 5 月 5 日以降はサービスまたは保守が終了します。 他のすべてのAzure Maps API、サービス、タイルセット ID は、この廃止の影響を受けません。 アップグレードのガイダンスについては、移行ガイド の Elevation Services の廃止 に関するページを参照してください。 詳細については、非推奨ポリシー (https://aka.ms/azsdk/support-policies) を参照してください。

ドキュメント

作業の開始に役立つさまざまなドキュメントが用意されています

作業の開始

前提条件

製品へのパッケージの追加

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

Azure 管理ライブラリには、認証の TokenCredential 実装と HTTP クライアントの実装が HttpClient 必要です。

Azure Identity パッケージと Azure Core Netty HTTP パッケージは、既定の実装を提供します。

認証

既定では、Azure Active Directory トークン認証は、次の環境変数の正しい構成に依存します。

  • AZURE_CLIENT_ID Azure クライアント ID の場合は 。
  • AZURE_TENANT_ID Azure テナント 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 client
ElevationClient client = new ElevationClientBuilder()
    .credential(tokenCredential)
    .elevationClientId(System.getenv("MAPS_CLIENT_ID"))
    .buildClient();

このサンプル コードでは、グローバル Azure を前提としています。 それ以外の場合は変数を変更 AzureEnvironment.AZURE してください。

その他のオプションについては、「 認証」 を参照してください。

主要な概念

Azure 管理ライブラリの設計と主要な概念の一般的な概要については、 API の設計 に関するページを参照してください。

例

ポイントのデータを取得する

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

ポリラインのデータを取得する

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

境界ボックスのデータを取得する

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

トラブルシューティング

Azure Maps サービスを操作すると、Maps サービスによって返されるエラーは、REST API 要求に対して返されるのと同じ HTTP 状態コードに対応します。

たとえば、無効な座標で検索すると、"Bad Request"400 を示すエラーが返されます。

次の手順

SDK の GitHub リポジトリには、いくつかのAzure Maps Elevation Java SDK サンプルが用意されています。 Azure Maps標高のサンプル

共同作成

このリポジトリへの投稿の詳細については、 投稿ガイドを参照してください。

  1. フォーク
  2. 機能ブランチを作成する (git checkout -b my-new-feature)
  3. 変更をコミットする (git commit -am 'Add some feature')
  4. ブランチにプッシュする (git push origin my-new-feature)
  5. 新しい Pull Request を作成する

インプレッション数