Quickstart: Your First Map in 60 Seconds
Embed a luxury French basemap on any web page with just a single container and standard script tags.
Sextant OpenMap delivers vector tiles directly from Cloudflare R2 object storage with global edge caching. To render a map, load MapLibre GL JS and initialize the Sextant style:
<!DOCTYPE html>
<html>
<head>
<!-- 1. MapLibre GL JS CSS & JS -->
<link rel="stylesheet" href="https://unpkg.com/maplibre-gl@4.7.1/dist/maplibre-gl.css" />
<script src="https://unpkg.com/maplibre-gl@4.7.1/dist/maplibre-gl.js"></script>
<style>
#map { width: 100%; height: 550px; border-radius: 12px; }
</style>
</head>
<body>
<!-- 2. Map Container -->
<div id="map"></div>
<script>
// 3. Initialize Map with Sextant Vector Tiles
const map = new maplibregl.Map({
container: 'map',
style: 'https://pub-8aec30e7013249bab5d8d5c9d5c5a7aa.r2.dev/style.json',
center: [2.3522, 48.8566], // Paris, France
zoom: 11,
minZoom: 2,
maxZoom: 14 // Enforced zoom cap for optimal real estate performance
});
</script>
</body>
</html>
maxZoom: 14 displays all building footprints and parcels without requesting non-existent higher zoom tiles.
Package Installation (@sextant/maps)
TypeScript-first client wrapper with built-in luxury themes, French territory bounding, and real estate pin helpers.
npm install @sextant/maps maplibre-gl
# or using yarn
yarn add @sextant/maps maplibre-gl
# or using pnpm
pnpm add @sextant/maps maplibre-gl
The package includes full TypeScript declarations (index.d.ts), ESM build for modern bundlers (Vite, Webpack, Turbopack), and a standalone UMD bundle for direct browser inclusion.
Vanilla HTML & CDN Script Tag
Embed directly in WordPress, Webflow, Shopify, or plain static HTML pages.
Include the UMD bundle hosted on the Cloudflare R2 edge or your own static asset server:
<!-- Cloudflare Edge CDN Bundle -->
<script src="https://pub-8aec30e7013249bab5d8d5c9d5c5a7aa.r2.dev/dist/index.umd.cjs"></script>
<script>
const { SextantMap, MAP_THEMES } = window.SextantMaps;
const mapInstance = new SextantMap({
container: 'property-map-container',
theme: 'riviera', // 'light' | 'dark' | 'riviera'
center: [7.425, 43.738], // French Riviera (Nice / Monaco)
zoom: 12
});
</script>
React, Next.js & Vue 3 Integration
Declarative integration with automatic map lifecycle cleanup and dynamic property pin rendering.
Next.js (App Router / Pages Router) & React
Because MapLibre GL JS interacts with the DOM canvas, render the map inside a client-side component (using "use client" in Next.js 13/14+):
"use client";
import React, { useEffect, useRef } from "react";
import { SextantMap, SextantProperty } from "@sextant/maps";
import "maplibre-gl/dist/maplibre-gl.css";
interface PropertyMapProps {
properties: SextantProperty[];
theme?: "light" | "dark" | "riviera";
center?: [number, number];
zoom?: number;
}
export function PropertyMap({
properties,
theme = "light",
center = [2.3522, 48.8566],
zoom = 12
}: PropertyMapProps) {
const mapContainerRef = useRef<HTMLDivElement>(null);
const mapInstanceRef = useRef<SextantMap | null>(null);
useEffect(() => {
if (!mapContainerRef.current) return;
// 1. Initialize Map
const map = new SextantMap({
container: mapContainerRef.current,
theme: theme,
center: center,
zoom: zoom,
maxZoom: 14
});
mapInstanceRef.current = map;
// 2. Add Property Markers
properties.forEach((prop) => {
map.addProperty(prop);
});
// 3. Cleanup on Unmount
return () => {
map.destroy();
};
}, [theme, center, zoom]);
return (
<div
ref={mapContainerRef}
style={{ width: "100%", height: "600px", borderRadius: "16px", overflow: "hidden" }}
/>
);
}
Curated Map Themes & Paint Overrides
Three production-calibrated themes designed specifically to complement luxury real estate imagery.
| Theme | Key Palette | Primary Use Case |
|---|---|---|
| Sextant Light | #f8fafc bg, #d8e2eb urban, #96dce7 water |
Default editorial look. Ideal for property listing pages and print exports. |
| Midnight Dark | #0a131e bg, #192c42 urban, #082234 water |
Prestige luxury villas, night-mode dashboards, and high-contrast presentations. |
| Riviera Teal | #fbf9f5 bg, #e5dacb urban, #0098a8 water |
Warm Mediterranean coastal estates, French Riviera, and French Caribbean listings. |
// Switch theme dynamically at runtime without page reloads
map.setTheme('riviera');
// Or apply custom color overrides
map.setPaintOverride({
waterFill: '#0284c7',
urbanFill: '#e0e7ff',
reliefOpacity: 0.2
});
Multilingual Vector Labels (i18n)
Render map nomenclature and geographical place labels in any language dynamically at runtime without reloading tiles.
Sextant OpenMap vector tiles pre-encode rich multilingual attributes (name:en, name:fr, name:de, name:es, name:it, name:ru, name:zh, name:ar, name:latin, etc.) on all place, city, transport, and geographical layers. Language switching operates 100% on the client canvas via MapLibre GL JS layout expressions, incurring zero additional bandwidth or tile downloads.
| Language Code | Language Name | Sample Label (Nice / Paris) | Fallback Behavior |
|---|---|---|---|
local |
Native French / Latin | Nice, Paris, Marseille | Default OSM name / Latin |
en |
English | Nice, Paris, Corsica | name:en → Latin → Local |
de |
German (Deutsch) | Nizza, Paris, Korsika | name:de → Latin → Local |
it |
Italian (Italiano) | Nizza, Parigi, Corsica | name:it → Latin → Local |
es |
Spanish (Español) | Niza, París, Córcega | name:es → Latin → Local |
ru |
Russian (Русский) | Ницца, Париж, Корсика | name:ru → Latin → Local |
zh |
Chinese (中文) | 尼斯, 巴黎, 科西嘉 | name:zh → Latin → Local |
ja |
Japanese (日本語) | ニース, パリ, コルシカ島 | name:ja → Latin → Local |
ar |
Arabic (العربية) | نيس, باريس, كورسيكا | name:ar → Latin → Local (RTL auto) |
import { createSextantMap, setMapLanguage, setTranslatePlaceNames, setMapBilingual } from '@sextant/maps';
// 1. Initialize map with options:
// - translatePlaceNames: false keeps authentic French names for cadastral accuracy and physical navigation
// - bilingual: true displays dual names simultaneously (e.g. "Nice (Nice)")
const map = createSextantMap({
container: 'map',
territory: 'cote-azur',
theme: 'riviera',
language: 'en',
translatePlaceNames: true, // default: true
bilingual: false // default: false
});
// 2. Switch language dynamically at runtime without map reload
document.getElementById('lang-select').addEventListener('change', (e) => {
setMapLanguage(map, e.target.value, { translatePlaceNames: true });
});
// 3. Toggle authentic French place names for property viewings & road signs
document.getElementById('btn-french-toggle').addEventListener('click', () => {
// Pass false to restore native French names (coalesce name, name:latin)
setTranslatePlaceNames(map, false);
});
// 4. Toggle bilingual dual nomenclature: "London (Londres)"
document.getElementById('btn-bilingual-toggle').addEventListener('click', () => {
setMapBilingual(map, true);
});
Custom Property Markers & Popups
Render high-end price badges, interactive cards, and boundary polygons.
map.addProperty({
id: "prop-4921",
coordinates: [7.2620, 43.7102], // Nice, Promenade des Anglais
title: "Belle Époque Seafront Apartment",
price: "€1,950,000",
bedrooms: 3,
surface: "145 m²",
imageUrl: "https://images.unsplash.com/photo-1600585154340-be6161a56a0c?auto=format&w=600&q=80",
url: "https://www.sextantproperties.com/properties/nice-seafront-4921"
});
Vector Tile Endpoints & URL Contract
Strict HTTP contract designed for Cloudflare R2 and Edge CDN distribution.
Vector tiles are stored as discrete, pre-gzipped Mapbox Vector Tile (.mvt) objects under immutable release paths:
| Endpoint | Format | Cache Policy | Description |
|---|---|---|---|
/manifest.json |
JSON | max-age=120 |
Points to the current active immutable release ID. |
/releases/{release}/tiles/{z}/{x}/{y}.mvt |
MVT (gzip) | max-age=31536000, immutable |
Individual vector tile binary payloads (z0 to z14). |
/releases/{release}/style.json |
JSON | max-age=300 |
MapLibre GL vector style specification for the release. |
Customization Wizard & URL Query Parameters
Hydrate and configure the interactive map via URL query parameters for zero-state embeds, email campaigns, CRM links, and agent generation.
The /sample interactive map endpoint natively inspects window.location.search on startup. Any parameter omitted falls back to its default production setting:
| Parameter | Type / Options | Default | Description |
|---|---|---|---|
theme |
light | dark | riviera |
light |
Cartographic theme colorway and styling preset. |
lat, lng |
Float (e.g. 43.7384, 7.4250) |
Monaco Riviera | Initial camera center coordinates in WGS-84 decimal degrees. |
zoom |
Float (2.0 to 14.0) |
12.0 |
Camera zoom level (strictly clamped to max 14). |
pins |
1 | 0 or true | false |
1 |
Whether to render luxury real estate price markers and popup cards. |
sidebar |
1 | 0 or true | false |
1 |
Show or hide the property listings sidebar filter panel. |
source |
r2 | local |
r2 |
Tile delivery source (Cloudflare R2 Edge vs. local test server). |
lang |
local | en | fr | de | es | it | ru | ... |
en |
Map nomenclature labels and UI interface language (supports 12 languages). |
https://maps.sextantproperties.com/sample?theme=riviera&lat=43.7384&lng=7.4250&zoom=12.5&pins=1&sidebar=1&lang=en
Autonomous AI Agent Integration & MCP Protocol
Connect LLMs and autonomous coding assistants directly to Sextant OpenMap via Model Context Protocol (MCP) and JSON Tool Calling.
Sextant OpenMap features a built-in Model Context Protocol (MCP) server running on server.py. This allows AI systems like Claude Desktop, Antigravity IDE, Gemini CLI, and Cursor to inspect territory bounds, query real estate listings, and render responsive vector maps on demand.
1. MCP Server Configuration
Add the Sextant Maps MCP server to your AI environment's configuration file (e.g., claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"sextant_maps": {
"command": "python3",
"args": ["/absolute/path/to/SextantOpenMap/server.py"],
"env": {
"PORT": "8080"
}
}
}
}
2. Standard LLM Tool Declaration (OpenAI / Gemini / Anthropic)
Use the following structured JSON schema to define the render_french_property_map tool within your agent's system prompt or tool array:
{
"type": "function",
"function": {
"name": "render_french_property_map",
"description": "Generate an interactive, high-performance French real estate vector map centered on specific coordinates or territories with custom pins and styling.",
"parameters": {
"type": "object",
"properties": {
"territory": {
"type": "string",
"enum": ["paris", "french_riviera", "bordeaux", "lyon", "cannes", "biarritz", "custom"],
"description": "Pre-configured territory or custom coordinates"
},
"theme": {
"type": "string",
"enum": ["light", "dark", "riviera"],
"default": "light",
"description": "Visual theme tailored for luxury property presentation"
},
"coordinates": {
"type": "array",
"items": { "type": "number" },
"description": "[longitude, latitude] center coordinates if territory is 'custom'"
},
"zoom": {
"type": "number",
"minimum": 3,
"maximum": 14,
"default": 12,
"description": "Initial zoom level (enforces architectural zoom 14 cap)"
},
"enable_pins": {
"type": "boolean",
"default": true,
"description": "Whether to display interactive price badges and listing cards"
}
},
"required": ["territory"]
}
}
}
3. LangChain & Python Integration
from langchain_core.tools import tool
@tool
def render_french_property_map(territory: str, theme: str = "light", zoom: float = 12.0) -> dict:
"""Renders a sovereign French vector map URL with pre-calibrated luxury real estate presets."""
presets = {
"paris": {"lat": 48.8566, "lng": 2.3522},
"french_riviera": {"lat": 43.7384, "lng": 7.4250},
"bordeaux": {"lat": 44.8378, "lng": -0.5792},
"lyon": {"lat": 45.7640, "lng": 4.8357}
}
coords = presets.get(territory, {"lat": 48.8566, "lng": 2.3522})
url = f"https://maps.sextantproperties.com/sample?theme={theme}&lat={coords['lat']}&lng={coords['lng']}&zoom={zoom}&pins=1"
return {
"url": url,
"iframe_html": f'<iframe src="{url}" width="100%" height="600" frameborder="0"></iframe>',
"territory": territory,
"theme": theme
}
OpenStreetMap Attribution & ODbL Compliance
Legal requirements for displaying maps powered by OpenStreetMap and Sextant styling.
OpenStreetMap data is licensed under the Open Database License 1.0 (ODbL). All web pages and mobile applications embedding Sextant OpenMap must provide visible attribution to OpenStreetMap contributors.
© <a href="https://www.openstreetmap.org/copyright" target="_blank">OpenStreetMap contributors</a> · Styled for <a href="https://www.sextantproperties.com" target="_blank">Sextant Properties</a>
The @sextant/maps client library includes this attribution by default in all initialized maps. Do not disable or obscure the attribution element.