Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule wyjaśniono, jak przeprowadzić migrację interfejsów API usługi Azure Maps Route w wersji 1.0 do usługi Azure Maps Route v2025-01-01 . W poniższej tabeli przedstawiono interfejsy API usługi Route w wersji 1.0 i opcje migracji.
Istotne różnice
Istotne różnice w kierunkach tras
| Funkcja | Wersja 1.0 | wersja 2025-01-01 |
|---|---|---|
| Operacje wsadowe | Synchronizacja i żądania asynchroniczne | Żądania synchronizacji |
| Format współrzędnych | Szerokość geograficzna/długość geograficzna | Długość/szerokość geograficzna zgodnie z definicją w formacie GeoJSON. |
| Model zużycia energii elektrycznej | Wsparte | Niewspierane |
| Lokalizacja | Użyj parametru "language", aby zlokalizować język instrukcji dotyczących trasy. | Użyj nagłówka żądania "Accept-Language", aby wprowadzić kod lokalizacji w celu zlokalizowania języka instrukcji dotyczących trasy. |
| Typ żądania | POBIERZ, OPUBLIKUJ | Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". |
| Format odpowiedzi | XML, JSON | GeoJSON |
| Tryb podróży | Samochód, ciężarówka, pieszy. Profile beta: Autobus, rower, motocykl, taksówka, van. |
Samochód, ciężarówka, pieszy. |
| Optymalizacja waypointów | Wsparte | Obecnie obsługiwane tylko w przypadku wyznaczania tras dla transportu ciężarowego. |
| Punkty drogi | Wsparte | Wsparte. Obsługuje również tryby viaWaypoints jazdy i chodzenia. |
Znaczące różnice w macierzy tras
| Funkcja | Wersja 1.0 | wersja 2025-01-01 |
|---|---|---|
| Format współrzędnych | Długość geograficzna/szerokość geograficzna | Długość geograficzna/szerokość geograficzna |
| Model zużycia energii elektrycznej | Wsparte | Niewspierane |
| Współrzędne wejściowe | Używa funkcji MultiPoint GeoJSON do współrzędnych wejściowych, ale żądanie jest w formacie JSON. | Prawidłowy typ geometrii MultiPoint w formacie GeoJSON. |
| Macierz: żądania asynchroniczne | Do 700 komórek | Do 50 000 komórek |
| Macierz: żądania synchroniczne | Do 100 komórek | Do 2500 komórek |
| Format odpowiedzi | JSON (JavaScript Object Notation) | GeoJSON (dane wejściowe i odpowiedzi) |
| Tryb podróży | Samochód, ciężarówka, pieszy. Profile beta: Autobus, rower, motocykl, taksówka, van. |
Samochód, ciężarówka, pieszy. |
Różnice istotne w zakresie tras
| Funkcja | Wersja 1.0 | wersja 2025-01-01 |
|---|---|---|
| Format współrzędnych | Szerokość geograficzna/długość geograficzna | Długość/szerokość geograficzna zgodnie z definicją w formacie GeoJSON. |
| Model zużycia energii elektrycznej | Wsparte | Nie jest obsługiwany |
| Typ żądania | POBIERZ, OPUBLIKUJ | Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". |
| Format odpowiedzi | XML, JSON | GeoJSON (dane wejściowe i odpowiedzi) |
| Tryby podróży | Samochód, ciężarówka. Profile beta: autobus, motocykl, taksówka, van |
Samochód, ciężarówka |
Użycie transakcji
Aby uzyskać informacje na temat sposobu obliczania transakcji, zobacz Omówienie transakcji usługi Azure Maps.
Przykłady usługi Route Service
Ta sekcja zawiera przykładowe żądania i odpowiedzi dla wersji 1.0 i 2025-01-01 dla interfejsu API kierunku trasy, macierzy tras i zakresu tras .
Przykłady tras kierunkowych
Przykładowe żądanie Route Directions w wersji 1.0
Interfejs API Route Directions w wersji 1.0 jest żądaniem HTTP GET . Wszystkie parametry są przekazywane jako parametry ciągu zapytania.
https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50895,13.42904&subscription-key={Your-Azure-Maps-Subscription-key}
Przykładowe żądanie Route Directions w wersji 2025-01-01
Interfejs API Route Directions w wersji 2025-01-01 jest żądaniem HTTP POST . Parametry można uwzględnić w wywołaniu interfejsu API jako parametry ciągu zapytania, a większą liczbę parametrów podać w treści żądania przy użyciu formatu GeoJSON.
https://atlas.microsoft.com/route/directions/json?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
Parametry zawarte w treści żądania HTTP POST są udostępniane jako GeoJSON.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
13.42936,52.50931
],
"type": "Point"
},
"properties": {
"pointIndex": 0,
"pointType": "waypoint"
}
},
{
"type": "Feature",
"geometry": {
"coordinates": [
13.42904,52.50895
],
"type": "Point"
},
"properties": {
"pointIndex": 1,
"pointType": "waypoint"
}
}
]
}
Przykład odpowiedzi Route Directions w wersji 1.0
{
"formatVersion": "0.0.12",
"routes": [
{
"summary": {
"lengthInMeters": 46,
"travelTimeInSeconds": 4,
"trafficDelayInSeconds": 0,
"trafficLengthInMeters": 0,
"departureTime": "2025-02-19T05:40:44+01:00",
"arrivalTime": "2025-02-19T05:40:47+01:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 46,
"travelTimeInSeconds": 4,
"trafficDelayInSeconds": 0,
"trafficLengthInMeters": 0,
"departureTime": "2025-02-19T05:40:44+01:00",
"arrivalTime": "2025-02-19T05:40:47+01:00"
},
"points": [
{
"latitude": 52.50931,
"longitude": 13.42937
},
{
"latitude": 52.50904,
"longitude": 13.42913
},
{
"latitude": 52.50895,
"longitude": 13.42904
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 2,
"sectionType": "TRAVEL_MODE",
"travelMode": "car"
}
]
}
]
}
Przykład odpowiedzi Route Directions w wersji 2025-01-01
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
13.429368,
52.509303
]
},
"properties": {
"routePathPoint": {
"legIndex": 0,
"pointIndex": 0
},
"order": {
"inputIndex": 0
},
"type": "Waypoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
13.429045,
52.50895
]
},
"properties": {
"routePathPoint": {
"legIndex": 0,
"pointIndex": 3
},
"order": {
"inputIndex": 1
},
"type": "Waypoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "MultiLineString",
"coordinates": [
[
[
13.429368,
52.509302
],
[
13.429225,
52.509145
],
[
13.429128,
52.509038
],
[
13.429044,
52.50895
]
]
],
"bbox": [
13.429044,
52.50895,
13.429368,
52.509302
]
},
"properties": {
"resourceId": "v70,h822083589,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t0,wTMPwETFBSkDPa-wS1dsqQA2~~~~~~~~~~v12,wTKYKRiVBSkAIWoEhq9sqQA2~~~~~~~~~~v12,k1,qatt:1",
"trafficCongestion": "Heavy",
"trafficDataUsed": "None",
"distanceInMeters": 44,
"durationInSeconds": 3,
"departureAt": "2025-02-19T05:41:07+00:00",
"arrivalAt": "2025-02-19T05:41:10+00:00",
"type": "RoutePath",
"legs": [
{
"distanceInMeters": 44,
"durationInSeconds": 3,
"departureAt": "2025-02-19T05:41:07+00:00",
"arrivalAt": "2025-02-19T05:41:10+00:00",
"routePathRange": {
"legIndex": 0,
"range": [
0,
3
]
},
"description": "An der Schillingbrücke"
}
]
}
}
]
}
Przykłady macierzy tras
Przykładowe żądanie macierzy tras w wersji 1.0
Interfejs API Post Route Matrix Sync w wersji 1.0 to żądanie HTTP POST. Parametry mogą być przekazywane jako parametry ciągu zapytania i w treści żądania przy użyciu formatu GeoJSON.
https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&travelMode=car&subscription-key={Your-Azure-Maps-Subscription-key}
Parametry zawarte w treści żądania HTTP POST są udostępniane jako dane JSON.
{
"origins": {
"type": "MultiPoint",
"coordinates": [
[
4.85106,
52.36006
],
[
4.85056,
52.36187
]
]
},
"destinations": {
"type": "MultiPoint",
"coordinates": [
[
4.85003,
52.36241
]
]
}
}
Przykładowe żądanie macierzy tras z dnia 2025-01-01
Interfejs API Route Matrix w wersji 2025-01-01 jest żądaniem HTTP POST. Parametry są przekazywane jako parametry ciągu zapytania i w treści żądania przy użyciu formatu GeoJSON.
https://atlas.microsoft.com/route/matrix/json?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
Parametry zawarte w treści żądania HTTP POST są udostępniane jako GeoJSON.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "MultiPoint",
"coordinates": [
[
4.85106,
52.36006
],
[
4.85056,
52.36187
]
]
},
"properties": {
"pointType": "origins"
}
},
{
"type": "Feature",
"geometry": {
"type": "MultiPoint",
"coordinates": [
[
4.85003,
52.36241
]
]
},
"properties": {
"pointType": "destinations"
}
}
],
"travelmode":"driving"
}
Przykład odpowiedzi macierzy tras w wersji 1.0
{
"formatVersion": "0.0.1",
"matrix": [
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 494,
"travelTimeInSeconds": 124,
"trafficDelayInSeconds": 0,
"trafficLengthInMeters": 0,
"departureTime": "2025-02-19T06:30:23+01:00",
"arrivalTime": "2025-02-19T06:32:27+01:00"
}
}
}
],
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 337,
"travelTimeInSeconds": 106,
"trafficDelayInSeconds": 0,
"trafficLengthInMeters": 0,
"departureTime": "2025-02-19T06:30:23+01:00",
"arrivalTime": "2025-02-19T06:32:08+01:00"
}
}
}
]
],
"summary": {
"successfulRoutes": 2,
"totalRoutes": 2
}
}
Przykład odpowiedzi Macierz Tras 2025-01-01
{
"type": "Feature",
"geometry": null,
"properties": {
"summary": {
"totalCount": 2,
"successfulCount": 2
},
"matrix": [
{
"statusCode": 200,
"originIndex": 0,
"destinationIndex": 0,
"durationTrafficInSeconds": 129,
"durationInSeconds": 129,
"distanceInMeters": 494
},
{
"statusCode": 200,
"originIndex": 1,
"destinationIndex": 0,
"durationTrafficInSeconds": 110,
"durationInSeconds": 110,
"distanceInMeters": 338
}
]
}
}
Przykłady zakresu tras
Przykładowe żądanie zakresu tras w wersji 1.0
Interfejs API Route Range w wersji 1.0 to żądanie HTTP GET. Wszystkie parametry są przekazywane jako parametry ciągu zapytania.
https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&travelmode=car&distanceBudgetInMeters=15&subscription-key={Your-Azure-Maps-Subscription-key}
Przykładowe żądanie zakresu tras w wersji 2025-01-01
Interfejs API Zakresu Tras w wersji 2025-01-01 to żądanie HTTP POST. Parametry można uwzględnić w wywołaniu interfejsu API jako parametry ciągu zapytania, a większą liczbę parametrów podać w treści żądania przy użyciu formatu GeoJSON.
https://atlas.microsoft.com/route/range?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
Parametry zawarte w treści żądania HTTP POST są udostępniane jako GeoJSON.
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
5.86605,50.97452
]
},
"properties": {
"distanceBudgetInMeters": 15,
"travelMode": "driving"
}
}
Przykład odpowiedzi zakresu tras w wersji 1.0
Wyniki odpowiedzi są obcięte w celu zwięzłości.
{
"formatVersion": "0.0.1",
"reachableRange": {
"center": {
"latitude": 50.97452,
"longitude": 5.86605
},
"boundary": [
{
"latitude": 50.97452,
"longitude": 5.86605
},
{
"latitude": 50.97452,
"longitude": 5.86605
},
{
"latitude": 50.97452,
"longitude": 5.86605
},
{
"latitude": 50.97452,
"longitude": 5.86605
}
]
}
}
Przykład odpowiedzi dla zakresu tras w wersji 2025-01-01
Wyniki odpowiedzi są obcięte w celu zwięzłości.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
5.86605,
50.97452
]
},
"properties": {
"type": "center"
}
},
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
5.86605,50.97452
],
[
5.8659, 50.97454
],
[
5.86584, 50.9745
],
[
5.86588, 50.97448
]
]
],
"bbox": [
5.86584,
50.97447,
5.86626,
50.97454
]
},
"properties": {
"type": "boundary"
}
}
]
}