Notatka
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ę interfejsu API Get a Static Map Bing Maps do interfejsu API Get Map Static Image usługi Azure Maps. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps renderuje prostokątny obraz mapy w stylu drogowym, satelitarnym/antenowym lub ruchu, zdefiniowany przez użytkownika.
Wymagania wstępne
- Konto Azure
- Konto usługi Azure Maps
- Klucz subskrypcji lub inna forma uwierzytelniania za pomocą usługi Azure Maps
Istotne różnice
- Mapy Bing zapewniają statyczny interfejs API map, oferujący style map takie jak Road, Satellite/Aerial, Traffic, Streetside, Birds Eye i Ordnance Survey. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps oferuje te same style, z wyjątkiem aplikacji Streetside, Birds Eye i Ordnance Survey.
- Mapy Bing API do uzyskiwania statycznej mapy obsługuje pobieranie mapy statycznej przy użyciu współrzędnych, adresu ulicy lub nazwy miejsca jako danych wejściowych dla lokalizacji. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps obsługuje tylko współrzędne jako dane wejściowe lokalizacji.
- Mapy Bing obsługują pobieranie natywnej statycznej mapy dla trasy jazdy, pieszej lub tranzytowej. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps nie zapewnia natywnie funkcji mapy tras.
- Interfejs API statycznych map Bing Maps udostępnia mapy w formatach obrazu PNG, JPEG i GIF. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps udostępnia mapy statyczne w formatach obrazów PNG i JPEG.
- Mapy Bing API dla statycznych map obsługuje formaty odpowiedzi XML i JSON. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps obsługuje tylko format odpowiedzi JSON.
- Mapy Bing: interfejs API statycznej mapy obsługuje żądania HTTP GET i POST. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps obsługuje żądania HTTP GET.
- Bing Maps Get a Static Map API używa współrzędnych w formacie szerokości i długości geograficznej. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps używa współrzędnych w formacie długości i szerokości geograficznej zgodnie z definicją w formacie GeoJSON.
- W przeciwieństwie do usługi Mapy Bing dla przedsiębiorstw, Azure Maps to globalna usługa, która obsługuje definiowanie zakresu geograficznego, co pozwala ograniczyć lokalizację danych do geograficznych obszarów Unii Europejskiej (UE) lub Stanów Zjednoczonych (USA). Wszystkie żądania (w tym dane wejściowe) są przetwarzane wyłącznie w określonym obszarze geograficznym. Aby uzyskać więcej informacji, zobacz Zakres geograficzny usługi Azure Maps.
Zabezpieczenia i uwierzytelnianie
Mapy Bing dla przedsiębiorstw obsługują tylko uwierzytelnianie klucza interfejsu API. Usługa Azure Maps obsługuje wiele sposobów uwierzytelniania wywołań interfejsu API, takich jak klucz subskrypcji, identyfikator Entra firmy Microsoft i token sygnatury dostępu współdzielonego (SAS). Aby uzyskać więcej informacji na temat zabezpieczeń i uwierzytelniania w usłudze Azure Maps, zobacz Uwierzytelnianie za pomocą usługi Azure Maps i sekcję Zabezpieczenia w dokumentacji usługi Azure Maps Get Map Static Image.
Parametry żądania
W poniższej tabeli wymieniono parametry żądania dla uzyskania mapy statycznej w Bing Maps oraz ich odpowiedniki w Azure Maps:
| Parametr żądania usługi Mapy Bing | Alias parametru | Parametr żądania usługi Azure Maps | Wymagane w usłudze Azure Maps | Typ danych usługi Azure Maps | Opis |
|---|---|---|---|---|---|
| punkt centralny | środek | True (jeśli nie używasz bbox) | liczba[] | Interfejs API statycznej mapy Bing Maps wymaga współrzędnych w formacie szerokości i długości geograficznej, natomiast interfejs API statycznego obrazu mapy w usłudze Azure Maps wymaga współrzędnych w formacie długości i szerokości geograficznej, zgodnie z definicją w formacie GeoJSON. longitude,latitude zakres od [-90, 90]. Uwaga: albo center, albo bbox są wymaganymi parametrami. Wzajemnie się wykluczają. |
|
| kultura | c | język | FAŁSZ | String | W interfejsie API pobierania statycznego obrazu mapy w usłudze Azure Maps jest to język, w którym powinny być zwracane wyniki wyszukiwania i jest określony w nagłówku żądania usługi Azure Maps. Aby uzyskać więcej informacji, zobacz Obsługiwane języki. |
| declutterPins | Dcl | Niewspierane | Nieobsługiwany | Nieobsługiwany | |
| dpi | dir | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | |
| narysujKrzywą | DV | Ścieżka | FAŁSZ | String | |
| pole widzenia | fov | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W usłudze Mapy Bing ten parametr jest używany dla imagerySet birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Usługa Azure Maps nie obsługuje tych stylów map. |
| format | fmt | format | PRAWDA | String | Interfejs API statycznych map Bing Maps udostępnia mapy w formatach obrazu PNG, JPEG i GIF. Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps udostępnia mapy statyczne w formatach obrazów PNG i JPEG. |
| nagłówek | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W Bing Maps parametr ten jest używany dla zestawu obrazów imagerySet: Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Usługa Azure Maps nie obsługuje tych stylów map. | |
| podświetlJednostkę | he | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W interfejsie API statycznej mapy w Mapach Bing ten parametr służy do uzyskania wielokąta wejściowej lokalizacji (obiekt) wyświetlanego na mapie natywnie. Usługa Azure Maps interfejs API pobierania statycznego obrazu mapy nie obsługuje tej funkcji, jednak można uzyskać wielokąt lokalizacji z interfejsu API Azure Maps Pobierz wielokąt, a następnie wyświetlić wielokąt na mapie statycznej. |
| zestaw obrazów | ID zestawu kafelków | PRAWDA | TilesetId | ||
| obszarMapy | ma | bbox | True (jeśli nie używa środka) | liczba[] | Pole ograniczenia zdefiniowane przez dwie długości geograficzne i dwie szerokości geograficzne reprezentuje cztery boki prostokątnego obszaru na Ziemi w formacie minLon, minLat, maxLon, maxLat. Uwaga: albo center, albo bbox są wymaganymi parametrami. Wzajemnie się wykluczają.
bbox nie należy używać z height lub width. |
| warstwa mapy | ml | trafficLayer | FAŁSZ | TrafficTilesetId | Opcjonalny. Jeśli TrafficLayer zostanie podane, zwraca obraz mapy z odpowiednią warstwą ruchu. Aby uzyskać więcej informacji, zobacz tilesetId. |
| rozmiar mapy | ms | wysokość | PRAWDA | liczba całkowita int32 | |
| szerokość | |||||
| mapMetadata | mmd | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | |
| orientacja | dir | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W interfejsie API "Pobierz statyczną mapę" usługi Bing Maps, ten parametr jest używany dla "imagerySet" Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Usługa Azure Maps nie obsługuje tych stylów map |
| prezentacja | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W ramach statycznego interfejsu API map w Mapach Bing, ten parametr jest używany dla ustawienia "imagerySet": Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Usługa Azure Maps nie obsługuje tych stylów map | |
| Pinezkę | Pp | Szpilki | FAŁSZ | String | W interfejsie API Statycznej Mapy Bing, żądanie HTTP GET jest ograniczone do 18 pinów, a żądanie HTTP POST do 100 pinów na każdą mapę statyczną. Żądanie HTTP GET dla interfejsu API statycznych obrazów w Azure Maps nie ma limitu liczby pinów na statyczną mapę. Jednak liczba numerów PIN obsługiwanych na mapie statycznej zależy od maksymalnej liczby znaków obsługiwanych w żądaniu HTTP GET. Aby uzyskać więcej informacji na temat obsługi pinezek, zobacz parametr "pins" interfejsu API statycznego obrazu mapy w usłudze Azure Maps w parametrach identyfikatora URI. |
| kwerenda | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API pobierania statycznego obrazu mapy w usłudze Azure Maps obsługuje tylko współrzędne jako dane wejściowe lokalizacji, a nie adres ulicy ani nazwa miejsca. Użyj interfejsu API Pobierania geokodowania w usłudze Azure Maps, aby przekonwertować adres ulicy lub nazwę miejsca na współrzędne. | |
| Parametry trasy: unikać | Brak | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API usługi Azure Maps dla statycznych obrazów nie udostępnia natywnie funkcji mapy tras. Aby uzyskać mapę statyczną z trasą, użyj interfejsu API Azure Maps Get Route Directions lub Post Route Directions, aby uzyskać współrzędne trasy danej trasy, a następnie użyj interfejsu API Get Map Static Image Azure Maps, aby nałożyć współrzędne trasy na mapę statyczną. |
| Parametry trasy: odległośćPrzedPierwszymSkrętem | dbft | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API statycznego obrazu usługi Azure Maps nie udostępnia natywnie funkcji mapy tras. Aby uzyskać statyczną mapę z zaznaczoną na niej trasą, możesz użyć interfejsów API Azure Maps Get Route Directions lub Post Route Directions, aby otrzymać współrzędne ścieżki trasy danej trasy, a następnie skorzystać z funkcji API Azure Maps Get Map Static Image, aby nałożyć współrzędne ścieżki na mapę statyczną. |
| Parametry trasy: dateTime | Dt | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | API statycznych obrazów Azure Maps nie udostępnia natywnie funkcji mapy tras. Aby uzyskać statyczną mapę z wytyczoną trasą, możesz użyć interfejsu API Azure Maps Get Route Directions lub Post Route Directions, aby otrzymać współrzędne ścieżki trasy, a następnie skorzystać z interfejsu API Azure Maps Get Map Static Image, aby nałożyć te współrzędne na mapę statyczną. |
| Parametry trasy: maxSolutions | maxSolns | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API statycznego obrazu usługi Azure Maps nie udostępnia natywnie funkcji mapy tras. Aby uzyskać statyczną mapę z naniesioną ścieżką trasy, możesz użyć interfejsu API Azure Maps Get Route Directions lub Post Route Directions, aby uzyskać współrzędne ścieżki trasy dla danej trasy, a następnie użyć funkcji interfejsu API Azure Maps Get Map Static ImagedrawCurve, aby nałożyć współrzędne ścieżki trasy na mapę statyczną. |
| Parametry trasy: optymalizowanie | optmz | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API do pobierania statycznych obrazów usługi Azure Maps nie oferuje funkcjonalności mapy tras w sposób natywny. Aby uzyskać statyczną mapę ze ścieżką trasy, możesz użyć API Azure Maps Get Route Directions lub Post Route Directions do pobrania współrzędnych trasy, a następnie skorzystać z funkcji API Azure Maps Get Map Static ImagedrawCurve do nałożenia współrzędnych na mapę statyczną. |
| Parametry trasy: typCzasu | TT | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API Azure Maps Get Maps Static Image nie zapewnia natywnej funkcjonalności mapy tras. Aby uzyskać statyczną mapę z zaznaczoną ścieżką trasy, możesz użyć interfejsu API Azure Maps Get Route Directions lub Post Route Directions, aby otrzymać współrzędne ścieżki danej trasy, a następnie skorzystać z funkcji interfejsu API Azure Maps Get Map Static Image, aby nanieść współrzędne ścieżki na mapę statyczną. |
| Parametry trasy: travelMode | Brak | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API statycznego obrazu usługi Azure Maps nie obsługuje natywnie funkcjonalności mapy tras. Aby uzyskać statyczną mapę z wytyczoną trasą, możesz użyć interfejsów API Get Route Directions lub Post Route Directions, aby pobrać współrzędne trasy, a następnie skorzystać z interfejsu API Get Map Static Image, aby nałożyć współrzędne ścieżki trasy na mapę statyczną. |
| Parametry trasy: waypoint.n | wp.n | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | Interfejs API statycznego obrazu usługi Azure Maps nie obsługuje natywnie funkcjonalności mapy tras. Aby uzyskać statyczną mapę z wytyczoną trasą, możesz użyć interfejsów API Get Route Directions lub Post Route Directions, aby pobrać współrzędne trasy, a następnie skorzystać z interfejsu API Get Map Static Image, aby nałożyć współrzędne ścieżki trasy na mapę statyczną. |
| styl | ul. | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | |
| regionUżytkownika | ur | widok | FAŁSZ | String | Ciąg reprezentujący kod regionu/kraju ISO 3166-1 Alfa-2. Powoduje to zmianę spornych geopolitycznych granic i etykiet w celu dopasowania ich do określonego regionu użytkownika. Domyślnie parametr Widok jest ustawiony na wartość "Auto", nawet jeśli nie jest zdefiniowany w żądaniu. Aby uzyskać więcej informacji, zobacz Obsługiwane widoki. |
| poziom zoomu | Powiększ | FAŁSZ | String | Żądany poziom powiększenia mapy. Wartość powiększenia musi należeć do zakresu: 0–20 (włącznie). Wartość domyślna to 12. | |
| podświetlJednostkę | he | Nieobsługiwany | Nieobsługiwany | Nieobsługiwany | W interfejsie API statycznej mapy w Mapach Bing ten parametr służy do uzyskania wielokąta wejściowej lokalizacji (obiekt) wyświetlanego na mapie natywnie. Usługa Azure Maps interfejs API pobierania statycznego obrazu mapy nie obsługuje tej funkcji, jednak można uzyskać wielokąt lokalizacji z interfejsu API Azure Maps Pobierz wielokąt, a następnie wyświetlić wielokąt na mapie statycznej. |
Aby uzyskać więcej informacji na temat parametrów żądania interfejsu API pobierania statycznego obrazu mapy usługi Azure Maps, zobacz Parametry URI.
Przykłady żądań
Mapy Bing Pobierz przykładowe żądanie GET dla interfejsu API statycznej mapy:
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.504810,-0.113629/15?mapSize=500,500&pp=51.504810,-0.113629;45&key={BingMapsKey}
Przykładowe zapytanie GET do interfejsu API usługi Azure Maps Get Map Static Image:
https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=15¢er=-0.113629,51.504810&height=500&Width=500&pins=default||-0.113629 51.504810||&subscription-key={Your-Azure-Maps-Subscription-key}
Przykłady odpowiedzi
Na poniższym zrzucie ekranu pokazano, co jest zwracane w treści odpowiedzi HTTP podczas wykonywania żądania mapy Bing Get a Static Map :
W poniższym przykładzie JSON pokazano, co jest zwracane w treści odpowiedzi HTTP podczas wykonywania żądania Get Map Static Image usługi Azure Maps:
Użycie transakcji
Podobnie jak w przypadku Bing Maps, interfejs API Mapy Statycznej, interfejs API Statycznych Obrazów Azure Maps rejestruje jedną rozliczaną transakcję na każde żądanie. Aby uzyskać więcej informacji na temat transakcji usługi Azure Maps, zobacz Omówienie transakcji usługi Azure Maps.
Dodatkowe informacje
Wsparcie