次の方法で共有

Bing Maps Get Traffic Incidents API を移行する

この記事では、Bing Maps Get Traffic Incidents API を Azure Maps Get Traffic Incident Detail API に移行する方法について説明します。 Azure Maps Get Traffic Incident Detail API は、建設現場、道路の閉鎖、事件、およびその他の交通に影響を与える可能性があり毎分更新される事故に関するデータを提供します。

前提条件

主な相違点

  • Azure Maps Get Traffic Incident Detail API は、マップ タイル上に交通事故を表示するためのものです。
  • Azure Maps では boundingbox に加えて boundingZoom が指定されている必要があります。 boundingZoom は、ラスター タイルとベクター タイルのズーム レベル (0 - 22) です。
  • Azure Maps では style が指定されている必要があります。 Azure Maps [Traffic Incident Tile] API でタイルをレンダリングするために使用されるスタイルです。 これは、応答内の交通事故の座標に影響します。
  • Azure Maps では、Azure Maps Get Traffic Incident Viewport API から取得される交通情報モデル (trafficModelId) を参照する番号が必要です。 これは毎分更新され、タイムアウトになる前の 2 分間有効です。間違った交通情報モデル ID が指定された場合、インターフェイスは正しい値を返します。 Azure Maps Get Traffic Incident Viewport API を使用する代わりに、Azure Maps Traffic Incident Tile 要求の交通情報モデル ID として -1 という値を渡すと、常に最新の交通情報モデルが呼び出されます。
  • Bing Maps Get Traffic Incidents API では、要求内での交通事故の重大度と種類の指定がサポートされています。 Azure Maps Get Traffic Incident Detail API はそうではなく、応答内で既定ですべての交通事故の重大度と種類を返します。
  • Azure Maps Get Traffic Incident Detail API は一般的に、Bing Maps Get Traffic Incidents API よりも詳細な交通の遅延に関する情報を提供します。 具体的には、Azure Maps では、dl 出力が交通事故によって引き起こされた遅延時間を秒単位で提供し、DelayMagnitude 出力が事故に関連する遅延の大きさを提供します (これらの値は、交通情報タイル内の事故の色に対応します)。
  • Bing Maps for Enterprise とは異なり、Azure Maps は地理的スコープの指定をサポートするグローバル サービスであり、データ所在地をヨーロッパ (EU) または米国 (US) の地理的領域 (geo) に制限できます。 (入力データを含む) すべての要求は、指定された地理的領域内でのみ処理されます。 詳しくは、「Azure Maps サービスの地域スコープ」をご覧ください。

セキュリティと認証

Bing Maps for Enterprise がサポートしているのは、API キー認証だけです。 Azure Maps は、サブスクリプション キー、Microsoft Entra ID、Shared Access Signature (SAS) トークンなど、API 呼び出しを認証する方法を複数サポートしています。 Azure Maps のセキュリティと認証の詳細については、Azure Maps Get Traffic Incident Detail ドキュメント内の「Azure Maps での認証」と「セキュリティ」のセクションを参照してください。

要求パラメーター

次の表は、Bing Maps Get Traffic Incidents の要求パラメーターと Azure Maps の同等なパラメーターを一覧表示したものです。

Bing Maps 要求パラメーター Bing Maps 要求パラメーターの別名 Azure Maps 要求パラメーター Azure Maps で必須であるか Azure Maps のデータ型 説明
mapArea boundingbox True number[] 要求と応答内で boundingbox 座標を指定するために使用されるプロジェクションは、EPSG900913 (既定値) または EPSG4326 です。 Bing Maps Get Traffic Incidents API で使用される座標プロジェクションとの互換性を保つには、projection=EPSG4326 を使用します。 
culture c  language False string 出力言語の ISO 639-1 コード。 詳細については、「Azure Maps でサポートされている言語」を参照してください。
includeJamcidents サポート対象外 サポートされていません サポート対象外 Azure Maps は、既定で異常な交通状態を返します。
severity s  サポート対象外 サポートされていません サポート対象外 Azure Maps は、既定ですべての重大度レベルの交通事故を返します。
type t  サポート対象外 サポートされていません サポート対象外 Azure Maps は、既定ですべての種類の交通事故を返します。

Azure Maps の要求パラメーターの詳細については、Azure Maps Get Traffic Incident Detail API ドキュメント内の「URI パラメーター」を参照してください。

要求の例

Bing Maps Get Traffic Incidents API 要求:

http://dev.virtualearth.net/REST/v1/Traffic/Incidents/37.8203,-122.2763,37.8321,-122.2542?key={Your-Bing-Maps-Key}

Azure Maps Get Traffic Incident Detail API 要求:

http://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=37.8203,-122.2763,37.8321,-122.2542&boundingZoom=11&projection=EPSG4326&trafficmodelid=-1&subscription-key={Your-Azure-Maps-Subscription-key}

応答フィールド

次の表は、Bing Maps Get Traffic Incidents API と Azure Maps での対応物を実行した際に HTTP 応答内に現れる可能性があるフィールドを一覧表示したものです。

Bing Maps 応答フィールド Azure Maps 応答フィールド 説明
Description (Json)
Description (XML) 		d  この出力は、Azure Maps の tm 応答要素内にあります。 
End (Json)
EndTimeUTC (XML) 		ed  この出力は、Azure Maps の tm 応答要素内にあります。 この日付は ISO8601 形式で記述され、UTC 時刻を含みます。 
eventList (Json)
EventList (XML) 		サポートされていません
icon (Json)
Icon (XML) 		ic  この出力は、Azure Maps の tm 応答要素内にあります。 詳細については、IconCategory (ic) を参照してください。 
incidentId (Json)
IncidentId (XML) 		id この出力は、Azure Maps の tm 応答要素内にあります。 
isEndTimeBackfilled (Json)
IsEndTimeBackfilled (XML) 		サポートされていません
isJamcident (Json)
IsJamcident (XML) 		サポートされていません
lastModified (Json)
LastModifiedUTC (XML) 		サポートされていません
point (Json)
Point (XML) 		p  この出力は、Azure Maps の tm 応答要素内にあります。 詳細については、point (p) を参照してください。 
roadClosed (Json)
RoadClosed (XML) 		説明を参照する Azure Maps の tm 応答要素の IconCategory 出力は、道路の閉鎖を表すために使用できます。  
severity (Json)
Severity (XML) 		ty  この出力は、tm 応答要素内にあります。 詳細については、DelayMagnitude: (ty) を参照してください。 
severityScore (Json)
SeverityScore (XML) 		サポートされていません
Start (Json)
StartTimeUTC (XML) 		sd  この出力は、Azure Maps の tm 応答要素内にあります。 この日付は ISO8601 形式で記述され、UTC 時刻を含みます。 
title (Json)
Title (XML) 		説明を参照する Azure Maps の tm 応答要素内の f 出力は、事故によって引き起こされた渋滞が始まる交差点または場所の名前を提供し、Bing Maps の title 出力の代わりとして使用できます。 
toPoint (Json)
ToPoint (XML) 		説明を参照する Azure Maps の tm 応答要素内の t 出力は、事故が原因の渋滞が終わる交差点または場所の名前を提供し、Bing Maps の toPoint 出力の代わりとして使用できます。 
type (Json)
Type (XML) 		c  Azure Maps の tm 応答要素内の c 出力は、入手可能な場合に事故の原因を提供します。 

Azure Maps Get Traffic Incident Detail API 応答フィールドの詳細については、「応答」を参照してください。

応答例

次の JSON サンプルは、Bing Maps Get Traffic Incidents 要求の実行時に、HTTP 応答の本文で返される内容を示しています。

{
    "authenticationResultCode": "ValidCredentials",
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
    "resourceSets": [
        { 
            "estimatedTotal: 1,
            "resources": [
                {
                    "__type": "TrafficIncident:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "point": {
                        "type": "Point",
                        "coordinates": [
                            37.824025,
                            -122.265829
                        ]
                    },
                    "alertCCodes": [
                        10
                    ],
                    "delay": 0,
                    "description": "Flooding on Telegraph Ave from I-580/W MacArthur Blvd to W MacArthur Blvd.",
                    "end": "/Date(1711764788159)/",
                    "eventList": [
                        907
                    ],
                    "icon": 0,
                    "incidentId": 14648704852012000,
                    "isEndTimeBackfilled": true,
                    "isJamcident": false,
                    "lastModified": "/Date(1711757588159)/",
                    "roadClosed": false,
                    "severity": 4,
                    "severityScore": 79,
                    "source": 5,
                    "start": "/Date(1711749960000)/",
                    "title": "Telegraph Ave",
                    "toPoint": {
                        "type": "Point",
                        "coordinates": [
                            37.824601,
                            -122.265675
                        ]
                    },
                    "type": 5,
                    "verified": true
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "35657cf08e01f49cd50543aa7d88c139|MWH0032BF3|0.0.0.0"
}

次の JSON サンプルは、Azure Maps Get Traffic Incident Detail 要求の実行時に HTTP 応答の本文で返される内容を示しています。

{
    "tm": {
        "@id": "1711765520",
        "poi": [
            {
                "id": "0043f39aed6a43411b869729bc30cba4",
                "p": {
                    "x": -122.2631419,
                    "y": 37.8235763
                },
                "ic": 11,
                "ty": 0,
                "cs": 0,
                "d": "Flooding",
                "sd": "2024-03-29T22:06:00Z",
                "f": "I-580/W MacArthur Blvd (Telegraph Ave)",
                "t": "W MacArthur Blvd (Telegraph Ave)",
                "l": 66
            }
        ]
    }
}

トランザクションの使用法

Bing Maps Get Traffic Incidents API と同様に、Azure Maps Get Traffic Incident Detail API では、要求ごとに 1 つの課金対象トランザクションがログされます。 Azure Maps トランザクションの詳細については、「Azure Maps トランザクションの理解」を参照してください。

追加情報

その他の Azure Maps Traffic API

  • Get Traffic Flow Segment。 道路の指定したセクションの速度と移動時間に関する情報を取得するために使用します。
  • Get Traffic Flow Tile。 交通の流れを表す 256 x 256 ピクセルのタイルを取得するために使用します。
  • Get Traffic Incident Tile。 交通事故を表す 256 x 256 ピクセルのタイルを取得するために使用します。
  • Get Traffic Incident Viewport。 ビューポートの法的情報と技術的情報を取得するために使用します。

サポート