Sextant Properties
OPENMAP PLATFORM
Fast Track

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:

index.html
<!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>
💡
Enforced Zoom Cap (Zoom 14): Sextant vector tiles are pre-rendered from zoom 0 to 14. Setting maxZoom: 14 displays all building footprints and parcels without requesting non-existent higher zoom tiles.
NPM & Modules

Package Installation (@sextant/maps)

TypeScript-first client wrapper with built-in luxury themes, French territory bounding, and real estate pin helpers.

Terminal
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.

Integration

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:

HTML
<!-- 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>
Frameworks

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+):

PropertyMap.tsx (Next.js 14+ Client Component)
"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" }} 
    />
  );
}
Styling

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.
Dynamic Theme Switching
// 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
});
Internationalization

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)
Dynamic Language & Nomenclature Options with @sextant/maps
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);
});
Overlays

Custom Property Markers & Popups

Render high-end price badges, interactive cards, and boundary polygons.

Adding Properties with Interactive Popups
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"
});
Infrastructure

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.
URL Hydration

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).
Example URL Generator
https://maps.sextantproperties.com/sample?theme=riviera&lat=43.7384&lng=7.4250&zoom=12.5&pins=1&sidebar=1&lang=en
Agentic Protocol

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):

claude_desktop_config.json / mcp_config.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:

tools.json (OpenAI / Gemini function declaration)
{
  "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

agent.py (LangChain Tool Definition)
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
    }
Compliance

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.

⚖️
Mandatory Attribution String:
© <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.