This application requires JavaScript.
maps.guru
maps for angular

Angular maps, the boring infra part sorted.

Drop maplibre-gl into ngAfterViewInit, store the instance on the component, and tear it down in ngOnDestroy. No Angular wrappers required.

Get a free API key Angular docs
install
pnpm add maplibre-gl
ts
import { AfterViewInit, Component, ElementRef, OnDestroy, ViewChild } from '@angular/core';
import maplibregl, { Map as MapLibreMap } from 'maplibre-gl';
import 'maplibre-gl/dist/maplibre-gl.css';

const MAP_STYLE = 'https://maps.guru/api/v1/styles/standard/light/style.json?key=YOUR_API_KEY';

@Component({
  selector: 'app-city-map',
  template: `<div #host class="map-canvas"></div>`,
  styles: [`.map-canvas { width: 100%; height: 480px; }`],
  standalone: true,
})
export class CityMapComponent implements AfterViewInit, OnDestroy {
  @ViewChild('host', { static: true }) host!: ElementRef<HTMLDivElement>;
  private map?: MapLibreMap;

  ngAfterViewInit(): void {
    this.map = new maplibregl.Map({
      container: this.host.nativeElement,
      style: MAP_STYLE,
      center: [77.209, 28.6139],
      zoom: 11,
    });
    this.map.addControl(new maplibregl.NavigationControl());
  }

  ngOnDestroy(): void {
    this.map?.remove();
  }
}
live · Angular preview

Why Angular teams ship on maps.guru

Free-tier generous enough for real production traffic. 50,000 tile requests/month , no credit card.

  • Mount inside ngAfterViewInit; the @ViewChild(ref) is queried before the lifecycle fires.
  • Tear down with map.remove() inside ngOnDestroy to release the WebGL context.
  • Standalone components keep the template + styles inline for trivial islands.

Frequently asked

  • Do I need an Angular wrapper package for MapLibre?

    No, using maplibre-gl directly is the most predictable path. The map instance lives in component memory and Angular handles subscription cleanup.

  • How do I change the map center from another component?

    Expose the MapLibreMap instance on a service via @Injectable({ providedIn: "root" }) so any component can read or call .flyTo() on it.

Mapping terms for Angular developers, defined

The vocabulary behind vector tiles, styles, and geocoding, in plain language.

What is Vector tile?

A vector tile is a compressed binary chunk of map geometry (roads, buildings, labels) that the browser styles and renders at runtime, instead of downloading a pre-drawn image. Vector tiles let one dataset power unlimited visual styles and stay sharp at every zoom level.

What is Basemap?

A basemap is the background map layer (roads, water, landuse, place labels) that your own data is drawn on top of. maps.guru serves basemaps as MapLibre-compatible vector tiles.

What is Map style?

A map style is a JSON document that tells a renderer which colours, fonts, widths, and zoom rules to apply to each layer of a vector tile. maps.guru styles follow the MapLibre Style Specification, so they work in any MapLibre or Mapbox GL JS compatible renderer.

What is Geocoding?

Geocoding is the process of converting a text address or place name into latitude and longitude coordinates. Reverse geocoding does the opposite: it converts coordinates into the nearest human-readable address.

What is PMTiles?

PMTiles is a single-file archive format for map tiles that supports HTTP range requests, so a tile server can read one tile out of a multi-gigabyte archive without unpacking it. maps.guru stores its tile archives as PMTiles on Cloudflare R2.

What is MapLibre GL JS?

MapLibre GL JS is an open-source WebGL map renderer, forked from Mapbox GL JS v1 after that project moved to a proprietary licence. It is the reference renderer for maps.guru styles and carries no per-render licence fee.

What is Tile request?

A tile request is one HTTP fetch of a single map tile. A typical desktop map view loads roughly 10 to 20 tiles, and panning or zooming loads more, which is why tile quotas are counted in tens of thousands rather than page views.

What is Static map?

A static map is a server-rendered PNG or JPEG image of a map at a fixed centre, zoom, and size. Static maps are used where an interactive map cannot run: email, PDF exports, Open Graph share cards, and AI chat replies.

Maps for other frameworks

  • svelte
    Svelte
    Idiomatic Svelte 5 runes with raw maplibre-gl.
    See snippet
  • tsx
    React
    MapLibre-native maps for React apps.
    See snippet
  • html
    JavaScript
    Drop-in maplibre-gl via CDN with no build step.
    See snippet

Ready to build with
beautiful basemaps?

Join developers worldwide who trust maps.guru for their mapping needs. Start free, no credit card required.

Contact us
Free forever plan
5-minute setup
No credit card

Stay updated

Product updates, pricing analysis, and mapping insights.

© 2026 maps.guru · Built in Pune, India

System status
  • APIChecking
  • MCPChecking