React Azure Maps からの画像 Preview

React IgrAzureMapsImagery は、Microsoft® が提供する地理的画像マッピング サービスです。 世界の地理的画像タイルを複数のスタイルで供します。この地理的画像サービスは、www.azure.microsoft.com ウェブサイトから直接アクセスできます。Ignite UI for React Map コンポーネントは、IgrAzureMapsImagery クラスを使用して、地図の背景コンテンツに Azure Maps の地理的画像を表示します。

React Azure Maps からの画像の表示 - 概要

React Azure Maps からの画像の表示 - コード例

以下のコード スニペットは、IgrAzureMapsImagery クラスを使用して React IgrGeographicMap で Azure Maps からの地理的画像タイルを表示する方法を示します。

<IgrGeographicMap
    ref={this.azureMapRef}
    height="100%"
    width="100%"
    zoomable={true} />

private azureMap: IgrGeographicMap
private azureMapRef(r: IgrGeographicMap) {
    this.azureMap = r;
    this.setState({});
}

this.azureMapRef = this.azureMapRef.bind(this);

var azureImagery = new IgrAzureMapsImagery();
azureImagery.apiKey = "YOUR_AZURE_MAPS_API_KEY";
azureImagery.imageryStyle = AzureMapsImageryStyle.Satellite;
this.azureMap.backgroundContent = azureImagery;

Azure Maps からの画像オーバーレイ - 概要

IgrGeographicTileSeries を使用する際には、ベース マップ スタイル (例: Satellite, Road, DarkGrey) の上にオーバーレイ (交通情報、天気、ラベル) を重ね合わせることができます。例えば Satellite と TerraOverlay を組み合わせることで、地形を視覚化できます。

• ベース スタイル: Satellite、Road、Terra、DarkGrey がコアとなる背景タイルを提供します。
• オーバーレイ スタイル: 交通情報や天気の画像 (TrafficRelativeOverlay、WeatherRadarOverlay など) は、タイル シリーズに割り当てることでベース スタイル上に重ねられるよう設計されています。
• ハイブリッド スタイル: HybridRoadOverlay や HybridDarkGreyOverlay などのバリエーションは、ベース スタイルにラベルや道路などのオーバーレイをあらかじめ組み合わせているため、複数のレイヤーを手動で管理する必要はありません。

この設計により、より豊かなマップ表現が可能になります。例えば:

• Satellite 画像に TrafficOverlay を重ねて、実際の地図上に渋滞状況をハイライト表示。
• Terra に WeatherRadarOverlay を組み合わせて、地形と降水を同時に視覚化。
• DarkGrey と LabelsRoadOverlay を適用し、ダッシュボードに適したコントラストの高いビューを実現。

Azure Maps からの画像オーバーレイ - コード例

次のコード スニペットは、IgrAzureMapsImagery クラスと IgrGeographicTileSeries クラスを使用して、React IgrGeographicMap の交通情報と濃い灰色のマップを結合した背景画像の上に地理画像タイルを表示する方法を示しています。

<IgrGeographicMap
    ref={this.azureMapRef}
    height="100%"
    width="100%"
    zoomable={true}>
    <IgrGeographicTileSeries
        name="imagerySeries"
        ref={ref => { this.imagerySeries = ref; }} />
</IgrGeographicMap>

private azureMap: IgrGeographicMap
private azureMapRef(r: IgrGeographicMap) {
    this.azureMap = r;
    this.setState({});
}
private imagerySeries: IgrGeographicTileSeries

this.azureMapRef = this.azureMapRef.bind(this);

var azureImagery = new IgrAzureMapsImagery();
azureImagery.apiKey = "YOUR_AZURE_MAPS_API_KEY";
azureImagery.imageryStyle = AzureMapsImageryStyle.DarkGrey;
this.azureMap.backgroundContent = azureImagery;
var trafficImagery = new IgrAzureMapsImagery();
trafficImagery.apiKey = "YOUR_AZURE_MAPS_API_KEY";
trafficImagery.imageryStyle = AzureMapsImageryStyle.TrafficAbsoluteOverlay;
this.imagerySeries.tileImagery = trafficImagery;

プロパティ

以下の表で、IgrAzureMapsImagery クラスのプロパティを説明します。

API リファレンス