{"canonical_url":"https://engineer.company/nb/glossary/mapbox/","content_markdown":"# Mapbox\n\n## Hva det er\n\nMapbox er både et selskap og utviklerplattformen det selger: delene i et interaktivt\nkart levert som tjenester, altså grunndataene, utseendet, koden som tegner kartet, og\nAPI-ene rundt. I kode dukker det ofte opp som Mapbox GL, etter tegnebiblioteket.\nSelskapets egen kom-i-gang-veiledning kaller det en lokasjonsplattform som gir utviklere\nbyggeklosser for kart, navigasjon og søk.\n\nKartdataene ligger i tilesets, som regel delt opp i vektorfliser, slik at en klient bare\nhenter det området og det zoomnivået som vises på skjermen. Mapbox vedlikeholder globale\ndatasett med grunndata, og et teams egne data kommer inn i et tileset via Mapbox Tiling\nService (MTS) eller Uploads API. Hvordan kartet ser ut, bestemmer en stil. Det er et\nJSON-dokument skrevet etter Mapbox Style Specification som navngir kildene sine og\nlister opp lag; hvert lag plukker ut objekter fra én kilde og sier hvordan de skal\ntegnes. Stiler adresseres med URL, f.eks. `mapbox://styles/mapbox/streets-v12`, og lages\ni kontoens konsoll med designverktøyet Mapbox Studio.\n\nMapbox GL JS tegner resultatet i en nettleser, og Maps SDK-ene for iOS og Android gjør\ndet samme i mobilapper. GL JS-veiledningen, som sto på versjon 3.33.0 da dette ble\nskrevet, sier at biblioteket gjengir 2D- og 3D-kart med OpenGL ved å kombinere\nvektorfliser med stilregler i nettleseren og ikke på en server. Det er derfor et kart\nkan bytte stil eller data mens noen bruker det. Static Images API returnerer et bilde av\net kart, og Static Tiles API leverer rasterfliser laget fra Studio-stiler til\nbiblioteker som Leaflet. Hvert kart opprettes med et tilgangstoken, og tokenet knytter\nkartet til en Mapbox-konto.\n\nSelve flisformatet, Mapbox Vector Tile-spesifikasjonen, er publisert åpent på GitHub og\nkoder hver flis som en [Protocol Buffers](https://protobuf.dev/)-melding.\n\n## Hvorfor det er viktig\n\nEt webkart trenger kode som tegner det, og data å tegne, enten fra én leverandør eller\nfra flere. Mapbox er svaret med én leverandør: data, stil, rendering og hosting under én\nkonto og på én regning. Å velge Mapbox er dermed å bestemme hvor mye av kartstakken dere\nvil leie.\n\nGevinstene er reelle. Grunndataene er det en annen som må holde oppdatert. Kartets\nutseende bor i et stildokument med sitt eget designverktøy, adskilt fra\napplikasjonskoden. Fordi tegningen skjer i nettleseren, kan ett tileset vises i flere\nstiler, et lag kan filtreres eller fargelegges på nytt ved et klikk, og det samme kartet\nkan vise terreng i 3D. For et produkt der hovedskjermen er kartet, er det mye arbeid som\nblir liggende hos leverandøren.\n\nKostnadene følger med den samme kontoen. GL JS faktureres per kartinnlasting (map load),\nog prisguiden teller én hver gang et `Map`-objekt initialiseres på en side. Panorering,\nzooming, av- og påslag av lag og bytte av stil inne i det kartet legger ingenting til,\nog én kartinnlasting varer i høyst 12 timer. Tokenet som kartet faktureres mot, ligger i\nnettleseren hos hver eneste besøkende. Og siden versjon 2.0.0, utgitt i desember 2020,\nhar selve renderen vært underlagt kommersielle vilkår: endringsloggen for den utgivelsen\nsier at GL JS ikke lenger er under 3-Clause BSD-lisensen, og at en oppgradering betyr å\ngodta Mapbox' tjenestevilkår.\n\nFlyttbarhet bør derfor avklares tidlig. Flisformatet er åpent. MapLibre GL JS begynte\nsom en fork med åpen kildekode av mapbox-gl-js, tatt før lisensendringen. 1.x-linjen var\nment som en direkte erstatning for åpen kildekode-utgaven av Mapbox 1.x, og README-en\nsier at prosjektet har utviklet seg mye siden. Det går an å forlate Mapbox, men det er\nen migrering, og den er billigere å vurdere før et produkt bygges rundt én leverandørs\nstiler og tilesets.\n\n## Slik ser det ut i praksis\n\nSom teamleder for GIS-programvareutvikling fra 2022 til 2024 var oppgaven å\n[styre fullstack-utviklingen av et GIS-kart som hadde vokst frem bit for bit](/nb/portfolio/directed-full-stack-gis-map-development/):\nromlige data i PostgreSQL, ReactJS i frontenden, NodeJS bak og Mapbox til å tegne\nkartet. Siden oppsummerer Mapbox-delen i én linje: Mapbox tok seg av tegningen, og\njobben var å mate det med de riktige dataene på de riktige zoomnivåene i stedet for alt\npå én gang. Resultatet ble én integrert kartapplikasjon som ble en kjernedel av\nplattformen og tok imot nye lag uten å knekke sammen.\n\nMed samme tittel, fra 2015 til 2022, satt rollen i\n[designprosessen for prosjektenes brukergrensesnitt](/nb/portfolio/contributed-to-user-interface-design-processes/),\npå React-, Angular- og Vue-frontender oppå Mapbox- og Leaflet-kart. Poenget på siden er\nat kartet er den enkle delen: folk går seg vill i kontrollene, filtreringen og flyten\nrundt det, i detaljer som det å bytte etasje i et innendørskart.\n\nSom dataingeniør fra 2022 til 2024 var jobben å\n[løse over 1 000 problemer i geografiske data og tidsseriedata](/nb/portfolio/resolved-1000-issues-in-geographical-data/)\nmed GDAL, QGIS, ArcGIS, PostGIS og Bash. De rensede dataene gikk deretter inn i\ninteraktive visualiseringer bygget med Mapbox, noe som gjorde dem lettere å nå for\nsluttbrukerne. Siden krediterer arbeidet som helhet med 35 % kortere kjøretid for\nromlige spørringer.\n\n## Hvor det går galt\n\nDe fleste problemene med Mapbox begynner når et kart møter ekte trafikk, ekte data eller\nen større oppgradering.\n\n**Regningen vokser med sidevisningene, ikke med bruken av kartet.** En kartinnlasting\ntelles ved initialisering, så kostnaden følger hvor ofte en side oppretter et kart. En\nenkeltsideapp (SPA) som lager `Map` på nytt ved hvert rutebytte, betaler hver gang, og\ndet gjør også et kart langt nede på en lang side som de fleste besøkende aldri ruller\nned til. Mapbox' veiledning om å holde kostnadene for webkart nede foreslår å opprette\nkartet først når beholderen ruller inn i visningsområdet, å legge det bak en Load\nMap-knapp og å bruke Static Images API der ingen trenger å panorere eller zoome. Én\nkartinstans som holdes i live på tvers av ruter, løser tilfellet med enkeltsideappen.\n\n**Et token som kopieres ut av siden, blir brukt andre steder.** Token-veiledningen slår\nfast at ethvert token på en offentlig nettside eller i kildekode er synlig for alle som\nleter etter det. Tokens med hemmelige scopes, `sk`-typen, hører hjemme på en server. Et\noffentlig `pk`-token på en side bør være laget for akkurat den applikasjonen, med\nURL-begrensninger, og ikke være kontoens standard offentlige token, som mangler slike\nbegrensninger. Veiledningen kaller URL-begrensninger et tiltak etter beste evne som er\navhengig av Referer-headeren nettleseren sender. Etter en lekkasje roterer du: lag et\nnytt token, bytt det inn i koden, produksjonssett på nytt, og slett deretter det gamle.\n\n**Kartet blir tregere etter hvert som datasettet vokser.** Klienten gjør en\nGeoJSON-kilde om til vektorfliser underveis, så en stor fil betyr at nettleseren til\nhver besøkende gjør flisingen. Veiledningen om store GeoJSON-kilder lister opp rådene:\nlast filen fra en URL i stedet for fra et JavaScript-objekt, senk kildens `maxzoom`\nunder standardverdien 18 (12 passer for de fleste punktdata), hev lagets `minzoom` over\n0, samle tette punkter i klynger, og fjern ubrukte egenskaper og desimaler etter den\nsjette. Det siste steget krymper eksempelfilen fra 19,3 MB til 3,3 MB. Over 500 000\npunkter foreslår veiledningen å dele opp kilden eller å lage flisene på serveren med MTS\neller Uploads API.\n\n```js\nmap.addSource(\"sites\", {\n    type: \"geojson\",\n    data: \"/data/sites.geojson\", // en URL, ikke et objekt i minnet\n    maxzoom: 12, // standardverdien er 18\n    cluster: true, // samle tette punkter ved lav zoom\n});\nmap.addLayer({\n    id: \"sites\",\n    type: \"circle\",\n    source: \"sites\",\n    minzoom: 6, // skjult under zoom 6\n});\n```\n\n**En større oppgradering endrer både lisensen og regningen.** Overgangen fra GL JS 1.x\ntil 2.0.0 flyttet biblioteket fra BSD-lisensen til Mapbox' tjenestevilkår og endret\nregelen for fakturering. Under 1.x krevde en kartinnlasting både en initialisering og en\nforespørsel etter en flis som Mapbox hostet; fra 2.0.0 teller initialiseringen alene, så\net kart som bare tegnet egenhostede fliser, begynner å generere kartinnlastinger.\nEndringsloggen ber deg lese prisdokumentasjonen før du oppgraderer, og MapLibre GL JS er\nveien å gå for et prosjekt som vil bli værende på vilkår med åpen kildekode.\n\n## Les mer\n\n- [Getting Started](https://docs.mapbox.com/help/getting-started/) — selskapets oversikt\n  over produktene for kart, søk og navigasjon.\n- [Mapbox GL JS pricing](https://docs.mapbox.com/mapbox-gl-js/guides/pricing/) — hva som\n  teller som en kartinnlasting, økten på 12 timer og de eldre reglene.\n- [Token management](https://docs.mapbox.com/accounts/guides/tokens/) — offentlige og\n  hemmelige tokens, scopes, URL-begrensninger og rotasjon.\n- [Working with large GeoJSON sources in Mapbox GL JS](https://docs.mapbox.com/help/troubleshooting/working-with-large-geojson-data/)\n  — zoomgrenser, klynger, opprydding og fliser laget på serveren.\n- [Mapbox Vector Tile specification](https://github.com/mapbox/vector-tile-spec) — det\n  åpne formatet bak flisene.\n- [MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js) — renderen med åpen\n  kildekode som startet som en fork av mapbox-gl-js.\n\n\u003chttps://engineer.company/nb/glossary/mapbox/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Mapbox for team som bygger webkart: tilesets, stiler og GL JS, prisen per kartinnlasting, lekkede tokens og lisensskiftet i versjon 2.0.0.","formats":{"gemtext":"https://engineer.company/nb/glossary/mapbox/index.gmi","gopher":"https://engineer.company/nb/glossary/mapbox/gophermap","html":"https://engineer.company/nb/glossary/mapbox/","json":"https://engineer.company/nb/glossary/mapbox/index.json","markdown":"https://engineer.company/nb/glossary/mapbox/index.md","pdf":"https://engineer.company/nb/glossary/mapbox/index.pdf"},"kind":"page","language":"nb","title":"Hva er Mapbox?","url":"https://engineer.company/nb/glossary/mapbox/","version":1}