Dela via

Viktig information om webb-SDK-kartkontroll

  • Artikel

Det här dokumentet innehåller information om nya funktioner och andra ändringar i kartkontrollen.

v3 (senaste)

3.5.0 (CDN: 4 november 2024, npm: 7 november)

Nya funktioner

  • Lägg till stöd för fullskärmskontroll.

Felkorrigeringar

  • Exponera ny typ på PolygonExtrusionLayerOptions.fillPattern för att stödja DataDrivenPropertyValueSpecification<string>.

3.4.0 (CDN: 30 september 2024, npm: 2 oktober)

Nya funktioner

  • Lägg till stöd för PMTiles.

Felkorrigeringar

  • Hjälpmedel: Åtgärda spillproblem med formatväljarens etikett i små containrar.
  • Korrigera attribution som inte uppdateras efter formatändringar med en GeoJSON-datakälla.
  • Åtgärda setCamera med gränser och min/max zoom.
  • Använd ResizeObserver i stället för att ändra storlek på fönsterhändelser.
  • Korrigera bredden på sidfotslogotypen.

Andra förändringar

  • Lägg till @types/geojson som ett beroende.
  • Uppdatera beroende till @microsoft/applicationinsights-web^3.3.0

3.3.0 (8 augusti 2024)

Nya funktioner

  • Uppdatera upphovsrättskontrollen
    • Gör upphovsrättstexten mindre och se till att den passar på en rad.
    • Använd olika typer av Microsoft-logotyper för olika CSS-teman för att förbättra synligheten.
    • Implementera RWD för att dölja en del av komponenten (MS-logotypen) när kartarbetsytan är relativt liten.
  • Förbättra basskiktsklassen genom att lägga till abstrakta getOptions och setOptions funktioner.

Felkorrigeringar

  • Hoppa över befintliga källor när du kopierar användarlager.
  • [BREAKING] Åtgärda felaktig ordning på latitud- och longitudvärden i Position.fromLatLng().
  • Åtgärda problem med dolda tillgängliga element som visas på kontrollknappar.

3.2.1 (13 maj 2024)

Nya funktioner

  • Begränsa vågrät panorering när renderWorldCopies är inställt på false.
  • Gör easeTo och flyTo animeringen jämnare när målpunkten ligger nära gränserna: maxBounds, lodräta världskanter eller antimeridian.

Felkorrigeringar

  • Korrigera tillgängliga nummer för dolda kontroller när du använder kommandot Visa siffror.
  • Åtgärda minnesläcka i arbetaren när kartan tas bort.
  • Åtgärda oönskade zoom- och panoreringsändringar i slutet av en panoreringsrörelse.

Andra förändringar

  • Förbättra formatet för infogad kod i dokumentet.

3.2.0 (29 mars 2024)

Andra förändringar

  • Uppgradera MapLibre till V4.

  • Korrigera standardvärdet HtmlMarkerOptions.pixelOffset för från [0, -18] till [0, 0] i dokumentet.

3.1.2 (22 februari 2024)

Nya funktioner

  • Alternativet fillAntialias för att aktivera MSAA-antialias på polygonfyllningar har lagts till PolygonLayer .

Andra förändringar

  • Uppdatera feedbackikonen och länken.

3.1.1 (26 januari 2024)

Nya funktioner

  • Lade till ett nytt alternativ, enableAccessibilityLocationFallback, för att aktivera eller inaktivera återställning av api för omvänd geokodning för hjälpmedel (skärmläsare).

Felkorrigeringar

  • Löste ett problem där ApplicationInsights v3.0.5 potentiellt skickade ett stort antal begäranden.

3.1.0 (12 januari 2024)

Nya funktioner

  • Lade till en ny kontroll, atlas.control.ScaleControl, för att visa ett skalningsfält på kartan.

  • Introducerade funktioner för att komma åt, uppdatera och ta bort ett funktionstillstånd.

Felkorrigeringar

  • Åtgärdat problemet med lagerordning efter en formatuppdatering när ett användarlager infogas före ett annat användarlager.

  • [BREAKING] Justerat beteendet för polygonfyllningsmönster med Maplibre. fillPattern Nu inaktiverar alternativet konsekvent alternativetfillColor. När du konfigurerar fillColor för polygonskikt kontrollerar du att fillPattern är inställt på undefined.

3.0.3 (29 november 2023)

Nya funktioner

  • ESM-stöd ingår.

Andra förändringar

  • Hjälpmedelsfunktionen för skärmläsaren har uppgraderats för att använda Search V2 API (omvänd geokodning).

  • Förbättrad tillgänglighet i kontrollerna Kompass och Tonhöjd.

3.0.2 (1 november 2023)

Felkorrigeringar

  • Åtgärdade flera fel i typdeklarationsfilen och lade till ett beroende för @maplibre/maplibre-gl-style-spec.

Andra förändringar

  • Auktoriseringshuvuden har tagits bort från format-, miniatyr-, sprite- och glyph-begäranden för att förbättra CDN-cachelagring för statiska tillgångar.

  • Uppdaterade dokumentationen för map.clear() och layers.clear().

3.0.1 (6 oktober 2023)

Felkorrigeringar

  • Olika hjälpmedelsförbättringar.

  • Löste problemet med dynamisk attribution när progressiv inläsning är aktiverad.

  • Åtgärdade saknade händelsenamn i HtmlMarkerEvents.

Andra förändringar

  • Ändrade medlemsmetoder som ska skyddas för kontrollerna zoom, tonhöjd och kompass.

  • Telemetri är inaktiverad som standard i Azure Government-molnet.

3.0.0 (18 augusti 2023)

Felkorrigeringar

  • Fast zoomkontroll för att ta hänsyn maxBounds till CameraOptions.

  • Åtgärdade ett problem med att muspositioner flyttas efter en css-skalningstransformering på kartcontainern.

Andra förändringar

  • Fasa ut formatdefinitionsversionen 2022-08-05 och växlade standardvärdet styleDefinitionsVersion till 2023-01-01.

  • Parametern mvc har lagts till för att omfatta kartkontrollversionen i både definitioner och formatbegäranden.

Installation

Versionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna på azure-maps-control@3.0.0

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.js"></script>

3.0.0-preview.10 (11 juli 2023)

Felkorrigeringar

  • Dynamiskt pixelförhållande fast i underliggande maplibre-gl-beroende.

  • Ett problem har åtgärdats där sortKey, radialOffset, variableAnchor inte tillämpas när det används i SymbolLayer alternativ.

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.10

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.js"></script>

3.0.0-preview.9 (27 juni 2023)

Nya funktioner

  • WebGL2 används som standard.

  • API:er för utökade privilegier: atlas.sources.ElevationTileSource, map.enableElevation(elevationSource, options), map.disableElevation()

  • Möjlighet att anpassa maxPitch/minPitch i CameraOptions

Felkorrigeringar

  • Ett problem där hjälpmedelsrelaterade duplicerade DOM-element kan uppstå när map.setServiceOptions anropas har åtgärdats

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.9

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.js"></script>

3.0.0-preview.8 (2 juni 2023)

Felkorrigeringar

  • Ett undantag som inträffade vid uppdatering av egenskapen för en layout som inte längre finns har åtgärdats.

  • Åtgärdade ett problem där BubbleLayers tillgängliga indikatorer inte uppdaterades när datakällan ändrades.

  • Ett fel har åtgärdats i efterföljande map.setStyle() anrop om det råa Maplibre-formatet hämtas i händelseåteranropet stylechanged vid format serialisering.

Andra förändringar

  • Attributionslogotypen och länken har uppdaterats.

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.8

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.js"></script>

3.0.0-preview.7 (2 maj 2023)

Nya funktioner

  • Förutom mappningskonfigurationen har Map.setServiceOptions() nu stöd för att ändra domain, styleAPIVersion, styleDefinitionsVersion vid körning.

Felkorrigeringar

  • Undantag för token som upphört att gälla vid omstarter vid användning av Azure AD/delad token/anonym autentisering genom att se till att autentiseringen har lösts före en formatdefinitionsbegäran

  • Fasta definitions- och miniatyrbegäranden för redundant formatmall

  • aria-label Fel tillämpades på knappelementet zooma ut kontroll

  • Åtgärdat möjligheten till odefinierad container för upphovsrättselement när withRuleBasedAttribution har angetts till false

  • Åtgärdat möjligheten att ta bort händelselyssnare som anropas på odefinierat mål i EventManager.remove()

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.7

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.js"></script>

3.0.0-preview.6 (31 mars 2023)

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.6

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.js"></script>

Nya funktioner

  • Optimerade prestanda för intern formatmallstransformering.

Felkorrigeringar

  • Löste ett problem där den första formatuppsättningsbegäran inte autentiserades för AAD autentisering.

  • Eliminerade redundanta begäranden under kartinitiering och ändrade formathändelser.

3.0.0-preview.5 (15 mars 2023)

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.5

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.js"></script>

Nya funktioner

  • Stöd för dynamisk uppdatering av mapConfiguration via map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

3.0.0-preview.4 (10 mars 2023)

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.4

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.js"></script>

Nya funktioner

  • Utökad karttäckning i Kina, Japan och Korea.

  • Förhandsversion av uppdaterade kartformat (Road / Night / Hybrid / Gray Scale Dark / Gray Scale Light / Terra / High Contrast Dark / High Contrast Light).

  • Mer information om vägar/byggnadsfotavtryck/spårtäckning.

  • Bredare zoomnivåintervall (1~21) för Terra-stilen.

  • Mer information om kollektivtrafik, inklusive färjor, tunnelbana och busshållplatser.

  • Ytterligare information om bergens höjd och vattenfallens läge.

Ändringar

  • Trafikdata stöder nu endast relativt läge.

  • Inaktuell i showBuildingModels StyleOptions.

  • Standardvärdet minZoom har ändrats från -2 till 1.

Felkorrigeringar

  • Rensat olika minnesläckor i Map.dispose().

  • Förbättrad formatväljarens fliknavigering för hjälpmedel i listlayouten.

  • Optimerad formatväxling genom att undvika djupkloningsobjekt.

  • Ett undantag som inträffade i SourceManager har åtgärdats vid formatväxling med källor som inte var vektorer eller raster.

  • [BREAKING] Tidigare sourceadded händelser genereras endast om nya källor läggs till i formatet. Nu sourceremoved / sourceadded genereras händelser när den nya källan och den ursprungliga källan i det aktuella formatet inte är lika med, även om de har samma käll-ID.

3.0.0-preview.3 (2 februari 2023)

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.3

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.js"></script>

Nya funktioner

Felkorrigeringar

  • Problem med språkmappning har åtgärdats och återgår nu zh-Hant-TW inte längre till en-US.

  • Åtgärdade oförmågan att växla mellan användarregioner (vy).

  • Ett undantag som uppstod vid formatväxling vid progressiv skiktinläsning pågår har åtgärdats.

  • Åtgärdade hämtningen av hjälpmedelsinformation från kartpanelsetikettlagren.

  • Åtgärdat ett tillfälligt problem där vektorpaneler inte återskapas efter att bilder har lagts till via ImageSpriteManager.add().

3.0.0-preview.2 (16 december 2022)

Installation

Förhandsversionen är tillgänglig på npm och CDN.

  • NPM: Se anvisningarna i azure-maps-control@3.0.0-preview.2

  • CDN: Referera till följande CSS och JavaScript i elementet <head> i en HTML-fil:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.js"></script>

Nya funktioner

Lägg till progressiveLoading och progressiveLoadingInitialLayerGroups till StyleOptions för att aktivera möjligheten att läsa in kartskikt progressivt. Den här funktionen förbättrar den upplevda inläsningstiden för kartan. Mer information finns i viktig information för 2.2.2.

Felkorrigeringar

  • Åtgärdade ett problem med att ordningen på användarskikt inte bevarats efter anropet map.layers.move().

  • Åtgärdade oförmågan att inaktivera trafikincidenter i TrafficControlOptions när new atlas.control.TrafficControl({incidents: false}) används.

  • Lägg till .atlas-map i alla css-väljare för att begränsa formatmallarna i kartcontainern. Korrigeringen hindrar css från att oavsiktligt lägga till oönskade formatmallar i andra element på sidan.

3.0.0-preview.1 (18 november 2022)

Installation

Förhandsversionen är tillgänglig på npm.

Nya funktioner

Den här uppdateringen är den första förhandsversionen av den kommande versionen av 3.0.0. Det underliggande maplibre-gl-beroendet har uppgraderats från 1.14 till 3.0.0-pre.1, vilket ger förbättringar i stabilitet och prestanda.

Felkorrigeringar

  • Ett regressionsfel som förhindrar att IndoorManager tar bort en paneluppsättning har åtgärdats:

    indoorManager.setOptions({
    tilesetId: undefined
})

v2

2.3.7 (22 februari 2024)

Nya funktioner

  • Alternativet fillAntialias för att aktivera MSAA-antialias på polygonfyllningar har lagts till PolygonLayer .
  • Lade till ett nytt alternativ, enableAccessibilityLocationFallback, för att aktivera eller inaktivera återställning av api för omvänd geokodning för hjälpmedel (skärmläsare).

Andra förändringar

  • Uppdatera feedbackikonen och länken.

2.3.6 (12 januari 2024)

Nya funktioner

  • Lade till en ny kontroll, atlas.control.ScaleControl, för att visa ett skalningsfält på kartan.

  • Introducerade funktioner för att komma åt, uppdatera och ta bort ett funktionstillstånd.

Felkorrigeringar

  • Åtgärdat problemet med lagerordning efter en formatuppdatering när ett användarlager infogas före ett annat användarlager.

2.3.5 (29 november 2023)

Andra förändringar

  • Hjälpmedelsfunktionen för skärmläsaren har uppgraderats för att använda Search V2 API (omvänd geokodning).

2.3.4 (1 november 2023)

Andra förändringar

  • Auktoriseringshuvuden har tagits bort från format-, miniatyr-, sprite- och glyph-begäranden för att förbättra CDN-cachelagring för statiska tillgångar.

  • Uppdaterade dokumentationen för map.clear() och layers.clear().

2.3.3 (6 oktober 2023)

Felkorrigeringar

  • Löste problemet med dynamisk attribution när progressiv inläsning är aktiverad.

2.3.2 (11 augusti 2023)

Felkorrigeringar

  • Ett problem där hjälpmedelsrelaterade duplicerade DOM-element kan uppstå när map.setServiceOptions anropas har åtgärdats.

  • Fast zoomkontroll för att ta hänsyn maxBounds till CameraOptions.

Andra förändringar

  • Parametern mvc har lagts till för att omfatta kartkontrollversionen i både definitioner och formatbegäranden.

2.3.1 (27 juni 2023)

Felkorrigeringar

  • Korrigering ImageSpriteManager av ikonbilder kan tas bort under formatändring

Andra förändringar

  • Säkerhet: korrigering av osäker slumpmässighet i UUID-generering.

2.3.0 (2 juni 2023)

Nya funktioner

  • [BREAKING] Omstrukturerade den interna StyleManager för att ersätta _stylePatch med transformStyle. Den här ändringen gör att ikonerna för vägsköldar kan uppdateras och återges korrekt efter en formatväxel.

Felkorrigeringar

  • Ett undantag som inträffade vid uppdatering av egenskapen för en layout som inte längre finns har åtgärdats.

  • Åtgärdade ett problem där BubbleLayers tillgängliga indikatorer inte uppdaterades när datakällan ändrades.

Andra förändringar

  • Attributionslogotypen och länken har uppdaterats.

2.2.7 (2 maj 2023)

Nya funktioner

  • Förutom mappningskonfigurationen har Map.setServiceOptions() nu stöd för att ändra domain, styleAPIVersion, styleDefinitionsVersion vid körning.

Felkorrigeringar

  • Undantag för token som upphört att gälla vid omstarter vid användning av Azure AD/delad token/anonym autentisering genom att se till att autentiseringen har lösts före en formatdefinitionsbegäran

  • Fasta definitions- och miniatyrbegäranden för redundant formatmall

  • aria-label Fel tillämpades på knappelementet zooma ut kontroll

  • Åtgärdat möjligheten till odefinierad container för upphovsrättselement när withRuleBasedAttribution har angetts till false

  • Åtgärdat möjligheten att ta bort händelselyssnare som anropas på ett odefinierat mål i EventManager.remove()

2.2.6

Felkorrigeringar

  • Löste ett problem där den första formatuppsättningsbegäran inte autentiserades för AAD autentisering.

  • Eliminerade redundanta begäranden under kartinitiering och ändrade formathändelser.

2.2.5

Nya funktioner

  • Stöd för dynamisk uppdatering av mapConfiguration via map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

2.2.4

Felkorrigeringar

  • Rensat olika minnesläckor i Map.dispose().

  • Förbättrad formatväljarens fliknavigering för hjälpmedel i listlayouten.

2.2.3

Nya funktioner

Felkorrigeringar

  • Problem med språkmappning har åtgärdats och återgår nu zh-Hant-TW inte längre till en-US.

  • Åtgärdade oförmågan att växla mellan användarregioner (vy).

  • Ett undantag som uppstod vid formatväxling vid progressiv skiktinläsning pågår har åtgärdats.

  • Åtgärdade hämtningen av hjälpmedelsinformation från kartpanelsetikettlagren.

  • Åtgärdat ett tillfälligt problem där vektorpaneler inte återskapas efter att bilder har lagts till via ImageSpriteManager.add().

2.2.2 (15 december 2022)

Nya funktioner

Lägg till progressiveLoading och progressiveLoadingInitialLayerGroups till StyleOptions för att aktivera möjligheten att läsa in kartskikt progressivt. Den här funktionen förbättrar den upplevda inläsningstiden för kartan.

  • progressiveLoading
    • Aktiverar progressiv inläsning av kartskikt.
    • Standardvärdet är false.
  • progressiveLoadingInitialLayerGroups
    • Anger de lagergrupper som ska läsas in först.
    • Standardvärdet är ["base"].
    • Möjliga värden är base, transit, labels, buildingsoch labels_places.
    • Andra lagergrupper skjuts upp så att de första lagergrupperna kan läsas in först.

Felkorrigeringar

  • Åtgärdade ett problem med att ordningen på användarskikt inte bevarats efter anropet map.layers.move().

  • Åtgärdade oförmågan att inaktivera trafikincidenter i TrafficControlOptions när new atlas.control.TrafficControl({incidents: false}) används.

Nästa steg

Utforska exempel som visar Azure Maps:

Azure Maps-exempel

Håll dig uppdaterad på Azure Maps:

Azure Maps-blogg