Azure Maps .NET 用共通クライアント ライブラリ - バージョン 1.0.0-beta.4

Azure Mapsは、マップ サービスを提供する Microsoft が管理するサービスです。

Azure.Maps.Common ライブラリは、他のAzure Mapsクライアント ライブラリ間で共有されるインフラストラクチャを提供します。

ソースコード | API リファレンス ドキュメント | 製品ドキュメント

作業の開始

パッケージをインストールする

NuGet で使用する .NET 用のAzure Maps クライアント ライブラリをインストールすると、Azure.Maps.Commonクライアント ライブラリが含まれます。 インストールするパッケージを選択します。

dotnet add package Azure.Maps.Search --prerelease
dotnet add package Azure.Maps.Routing --prerelease
dotnet add package Azure.Maps.Rendering --prerelease
dotnet add package Azure.Maps.Geolocation --prerelease

必須コンポーネント

Azure サブスクリプションとAzure Maps アカウントが必要です。

新しいAzure Maps アカウントを作成するには、Azure Portal、Azure PowerShell、または Azure CLI を使用できます。 Azure CLI を使う例を次に示します。

az maps account create --kind "Gen2" --account-name "myMapAccountName" --resource-group "<resource group>" --sku "G2"

クライアントを認証する

クライアントを認証するには、共有キー認証と Azure AD の 2 つの方法があります。 詳細については、他のAzure Maps パッケージを参照してください。

主要な概念

Azure Maps Common クライアント ライブラリには、LocalizedMapView や RequestFailedException などの共有インフラストラクチャが含まれています。

スレッド セーフ

すべてのクライアント インスタンス メソッドがスレッド セーフであり、相互に独立していることを保証します (ガイドライン)。 これにより、スレッド間であっても、クライアント インスタンスの再利用に関する推奨事項が常に安全になります。

その他の概念

クライアント オプション | 応答 | へのアクセス実行時間の長い操作 | エラーの | 処理診断 | あざける | クライアントの有効期間

使用例

検索、ルーティング、レンダリング、位置情報の例を参照してください。

トラブルシューティング

を nullLocalizedMapViewインスタンス化すると、プログラムはエラーを ArgumentNullException スローします。

次の手順

検索、ルーティング、レンダリング、位置情報のサンプルを開始します。

共同作成

このライブラリのビルド、テスト、および投稿の詳細については、 CONTRIBUTING.md を参照してください。

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、「cla.microsoft.com>」を参照してください<。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。