Udostępnij przez

Migrowanie interfejsów API dla ruchu drogowego w usłudze Azure Maps 1.0

Ten artykuł zawiera wskazówki dotyczące migrowania usługi Azure Maps Traffic v1 do innych usług Azure Maps.

W poniższej tabeli przedstawiono wszystkie usługi ruchu wraz z odpowiednimi opcjami migracji.

Ruch w Azure Maps wersja 1.0 Opcja migracji usługi Azure Maps
Pobierz segment przepływu ruchu Brak bezpośredniego zastąpienia.
Kafelki mapy mogą służyć do wizualizacji przepływu ruchu, ale szybkość i czas podróży nie są dostępne.
Uzyskaj kafelek przepływu ruchu
-Absolutny
- Zmniejszona czułość
-Krewny
- Opóźnienie względne 		Uzyskaj kafelek mapy
Identyfikator zestawu kafelków 
- microsoft.traffic.absolute (wektor)
- microsoft.traffic.absolute.main (rastrowy)
- microsoft.traffic.relative (vector)
- microsoft.traffic.relative.dark (rastr)
- microsoft.traffic.relative.main (raster)
- microsoft.traffic.delay (vector)
- microsoft.traffic.delay.main (raster)
- microsoft.traffic.reduced.main (raster)
Uzyskaj szczegóły incydentu drogowego Uzyskaj incydent drogowy 
Pobierz kafelek zdarzenia drogowego Pobierz kafelek mapy 
Identyfikator zestawu kafelków 
- microsoft.traffic.incident (vector)
Uzyskiwanie widoku zdarzeń drogowych Brak zamiany.
Zwraca identyfikator modelu ruchu używany przez usługę Traffic v1, ale nie jest wymagany dla najnowszego ruchu ani usług renderowania.

Istotne różnice

  • W przeciwieństwie do usługi Traffic v1.0, najnowszy interfejs API Get Traffic Incident w usłudze Azure Maps oraz API Get Map Tile w usłudze Render nie wymagają identyfikatora modelu ruchu.

  • Pole ograniczenia wejściowego Get Traffic Incident v2025-01-01 i odpowiedź są w formacie GeoJSON.

  • Traffic Flow Segment v1.0 zawiera informacje na temat prędkości pojazdów i czasów podróży segmentu drogowego. Te informacje nie są dostępne w najnowszej wersji oprogramowania, ale dane ruchu można wizualizować przy użyciu interfejsu API Render Get Map Tile.

  • Aby przypisać kategorię ikon do punktów zwróconych przez funkcję Get Traffic Incident v2025-01-01, użyj enumeracji podanej w odpowiedzi.

  • Kafelki mapy ruchu są dostępne w formacie wektorowym i rasterowym w usłudze Render przy użyciu interfejsu API Get Map Tile .

Użycie transakcji

Aby uzyskać informacje na temat sposobu obliczania transakcji dla usług Traffic and Render, zobacz Understanding Azure Maps Transactions (Omówienie transakcji usługi Azure Maps).

Przykłady usługi drogowej

Ta sekcja zawiera przykładowe żądania i odpowiedzi dotyczące wersji 1.0 oraz 2025-01-01 interfejsu API zdarzeń drogowych, a także wersji 2024-04-01 interfejsu API do renderowania kafelków mapy.

Przykład zdarzenia ruchu w wersji 1.0

Wersja 1.0 API Zdarzeń Drogowych to żądanie HTTP GET, które zwraca wszystkie zdarzenia drogowe w określonym prostokącie ograniczającym.

https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=37,-105,45,-94&boundingZoom=11&trafficmodelid=1335294634919&projection=EPSG4326&subscription-key={Your-Azure-Maps-Subscription-key}

Odpowiedź zawiera wszystkie zdarzenia ruchu w określonym polu ograniczenia w formacie JSON. Wyniki są obcięte w celu zwięzłości.

{
  "tm": {
    "@id": "1742459680",
    "poi": [
      {
        "id": "CLUSTER_80251",
        "p": {
          "x": -105.0012712,
          "y": 39.7117135
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": -105.0038575,
          "y": 39.7096459
        },
        "ctr": {
          "x": -104.99992,
          "y": 39.7148278
        },
        "cs": 4,
        "l": 1132
      },
      {
        "id": "CLUSTER_80249",
        "p": {
          "x": -105.0070862,
          "y": 39.7491353
        },
        "ic": 13,
        "ty": 0,
        "cbl": {
          "x": -105.0214434,
          "y": 39.7391984
        },
        "ctr": {
          "x": -104.9985481,
          "y": 39.7597951
        },
        "cs": 12,
        "l": 2276
      }
    ]
  }
}

Przykład zdarzenia ruchu w wersji 2025-01-01

Wersja interfejsu API Zdarzenia Ruchu z dnia 2025-01-01 to żądanie HTTP GET, które zwraca wszystkie incydenty drogowe w określonym polu ograniczenia.

https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-105,37,-94,45&subscription-key={Your-Azure-Maps-Subscription-key}

Odpowiedź zawiera wszystkie zdarzenia ruchu w określonym polu ograniczenia w formacie GeoJSON. W poniższym przykładzie pokazano pojedyncze zdarzenie ruchu typu "Wypadek":

{ 
  "type": "FeatureCollection", 
  "features": [ 
    { 
      "type": "Feature", 
      "id": 18558549332008001, 
      "geometry": { 
        "type": "Point", 
        "coordinates": [ 
          -104.939053, 
          39.682642 
        ] 
      }, 
      "properties": { 
        "startTime": "2025-09-12T09:31:37Z", 
        "endTime": "2025-09-12T10:21:47Z", 
        "description": "At CO 2/Colorado Boulevard (Denver) at Mile Point 204. Two right lanes are closed due to a crash.", 
        "title": "I-25 N / US-87 N", 
        "incidentType": "Accident", 
        "severity": 4, 
        "delay": null, 
        "lastModified": "2025-09-12T10:21:47Z", 
        "endPoint": { 
          "type": "Point", 
          "coordinates": [ 
            -104.940412, 
            39.68307 
          ] 
        }, 
        "isTrafficJam": false, 
        "isRoadClosed": false 
      } 
    } 
] 
}

Renderowanie kafelka mapy w usłudze Azure Maps, wersja 2024-04-01

API renderowania kafelków mapy Azure Maps to żądanie HTTP GET zwracające kafelki wektorowe z danymi o ruchu względnym.

Przykładowe żądanie

https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.traffic.relative&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

Przykładowa odpowiedź

Content-Type: application/vnd.mapbox-vector-tile

Ciąg znaków obrazu binarnego

  • Last updated on