googlemaps-kit 0.3.1 → 0.5.0

package/dist/rpc/tile-builders.js

@@ -0,0 +1,172 @@
+/**
+ * Tile URL builders for Google Maps tile services.
+ * Constructs URLs for fetching various map tile types (raster, terrain, 3D, Earth).
+ */
+/**
+ * Build a standard map tile URL.
+ * Format: https://mt.google.com/vt?x={x}&y={y}&z={z}&style={style}
+ */
+export function buildMapTileUrl(options) {
+    const style = options.style ?? 'roadmap';
+    const scale = options.scale ?? 1;
+    const params = new URLSearchParams({
+        x: String(options.x),
+        y: String(options.y),
+        z: String(options.zoom),
+        style,
+    });
+    if (scale > 1) {
+        params.set('scale', String(scale));
+    }
+    return `https://mt.google.com/vt?${params.toString()}`;
+}
+/**
+ * Build a traffic overlay tile URL.
+  * Format: https://mt.google.com/vt?lyrs=h,traffic&x={x}&y={y}&z={z}
+ */
+export function buildTrafficTileUrl(options) {
+    const params = new URLSearchParams({
+        // `traffic` on its own renders a fully transparent tile — mt.google.com only
+        // paints the congestion overlay when it is composited onto a base layer.
+        lyrs: 'h,traffic',
+        x: String(options.x),
+        y: String(options.y),
+        z: String(options.zoom),
+    });
+    if (options.scale && options.scale > 1) {
+        params.set('scale', String(options.scale));
+    }
+    return `https://mt.google.com/vt?${params.toString()}`;
+}
+/**
+ * Build a transit overlay tile URL.
+ * Format: https://mt.google.com/vt?lyrs=transit&x={x}&y={y}&z={z}
+ */
+export function buildTransitTileUrl(options) {
+    const params = new URLSearchParams({
+        lyrs: 'transit',
+        x: String(options.x),
+        y: String(options.y),
+        z: String(options.zoom),
+    });
+    if (options.scale && options.scale > 1) {
+        params.set('scale', String(options.scale));
+    }
+    return `https://mt.google.com/vt?${params.toString()}`;
+}
+/**
+ * Build a terrain overlay tile URL.
+ * Format: https://mt.google.com/vt?lyrs=p&x={x}&y={y}&z={z}
+ */
+export function buildTerrainTileUrl(options) {
+    const params = new URLSearchParams({
+        lyrs: 'p',
+        x: String(options.x),
+        y: String(options.y),
+        z: String(options.zoom),
+    });
+    if (options.scale && options.scale > 1) {
+        params.set('scale', String(options.scale));
+    }
+    return `https://mt.google.com/vt?${params.toString()}`;
+}
+/**
+ * Build a satellite / hybrid imagery tile URL.
+ *
+ * `earth.google.com` has no public tile API — the imagery the Maps web client
+ * renders comes from the same `mt.google.com/vt` host as the basemap, keyed
+ * `s` (satellite only) or `y` (satellite + roads and labels). Both answer JPEG.
+ */
+export function buildEarthTileUrl(options) {
+    const params = new URLSearchParams({
+        lyrs: options.imageType === 'satellite' ? 'y' : 's',
+        x: String(options.x),
+        y: String(options.y),
+        z: String(options.zoom),
+    });
+    if (options.scale && options.scale > 1) {
+        params.set('scale', String(options.scale));
+    }
+    return `https://mt.google.com/vt?${params.toString()}`;
+}
+/**
+ * Calculate Web Mercator tile coordinates from lat/lng.
+ * Useful for converting geographic coordinates to tile indices.
+ */
+export function lngLatToTile(lng, lat, zoom) {
+    const n = Math.pow(2, zoom);
+    const x = Math.floor(((lng + 180) / 360) * n);
+    const y = Math.floor(((1 - Math.log(Math.tan((lat * Math.PI) / 180) + 1 / Math.cos((lat * Math.PI) / 180)) / Math.PI) / 2) * n);
+    return { x, y, z: zoom };
+}
+/** Default tileset version epoch observed in Maps JS (Jul 2026). */
+export const DEFAULT_MAP_TILE_VERSION = 707_476_520;
+const VT_BASE = 'https://www.google.com/maps/vt';
+/** Default POI pin icon from Maps JS (`RFjZgc.js` asset registry). */
+export const DEFAULT_POI_ICON = 'assets/icons/poi/tactile/pinlet-2-medium.png';
+function layerPbParts(layer) {
+    switch (layer) {
+        case 'roadmap':
+            return { layerEnum: 0, styleMarker: 'm' };
+        default: {
+            const exhaustive = layer;
+            throw new Error(`Unhandled map tile layer: ${String(exhaustive)}`);
+        }
+    }
+}
+/** Build the pb string for a basemap tile request. */
+export function buildMapTilePb(params) {
+    const size = params.size ?? 256;
+    const layer = params.layer ?? 'roadmap';
+    const version = params.version ?? DEFAULT_MAP_TILE_VERSION;
+    const { layerEnum, styleMarker } = layerPbParts(layer);
+    return (`!1m5!1m4!1i${params.z}!2i${params.x}!3i${params.y}!4i${size}` +
+        `!2m3!1e${layerEnum}!2s${styleMarker}!3i${version}`);
+}
+function vtPath(endpoint) {
+    switch (endpoint) {
+        case 'proto':
+            return '/proto';
+        case 'stream':
+            return '/stream';
+        default: {
+            const exhaustive = endpoint;
+            throw new Error(`Unhandled map tile endpoint: ${String(exhaustive)}`);
+        }
+    }
+}
+/** Full URL for a pb-wrapped vector/basemap tile from the proto or stream endpoints. */
+export function buildProtoTileUrl(options) {
+    const endpoint = options.endpoint ?? 'proto';
+    const pb = buildMapTilePb(options);
+    return `${VT_BASE}${vtPath(endpoint)}?pb=${encodeURIComponent(pb)}`;
+}
+/**
+ * Pb for a named overlay layer tile.
+ *
+ * The Maps JS layer descriptor (`_.er`) serialises into the `!2m` block as
+ * field 1 = type enum, field 2 = layer name string. Hillshade publishes as
+ * type 5 ("shading"), contour lines as type 6 ("contours") and the air
+ * quality heatmap as a named data layer of type 2.
+ */
+export function buildOverlayTilePb(params) {
+    const size = params.size ?? 256;
+    const descriptor = params.layer === 'hillshade'
+        ? '!1e5!2sshading'
+        : params.layer === 'contours'
+            ? '!1e6!2scontours'
+            : '!1e2!2sair-quality-heatmap';
+    return (`!1m5!1m4!1i${params.z}!2i${params.x}!3i${params.y}!4i${size}` +
+        `!2m2${descriptor}`);
+}
+/** Full URL for an overlay layer tile (no network I/O). */
+export function buildOverlayTileUrl(options) {
+    const pb = buildOverlayTilePb(options);
+    return `${VT_BASE}/proto?pb=${encodeURIComponent(pb)}`;
+}
+/** Full URL for a POI icon asset (no network I/O). */
+export function buildIconUrl(params) {
+    const scale = params.scale ?? 2;
+    return `${VT_BASE}/icon/name=${params.name}?scale=${scale}`;
+}
+//# sourceMappingURL=tile-builders.js.map

package/dist/rpc/tile-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-builders.js","sourceRoot":"","sources":["../../src/rpc/tile-builders.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAM/B;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QACvB,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,6EAA6E;QAC7E,yEAAyE;QACzE,IAAI,EAAE,WAAW;QACjB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,SAAS;QACf,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,GAAG;QACT,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAMjC;IACC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACnD,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACpB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,GAAW,EACX,IAAY;IAEZ,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAClB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAC1G,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AA4BD,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC;AAEpD,MAAM,OAAO,GAAG,gCAAgC,CAAC;AAEjD,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,8CAA8C,CAAC;AAOjD,SAAS,YAAY,CAAC,KAAmB;IACvC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,KAAK,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,MAO9B;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAC;IAC3D,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEvD,OAAO,CACL,cAAc,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,IAAI,EAAE;QAC9D,UAAU,SAAS,MAAM,WAAW,MAAM,OAAO,EAAE,CACpD,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,QAAyB;IACvC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,QAAQ,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC7C,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAMlC;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;IAChC,MAAM,UAAU,GACd,MAAM,CAAC,KAAK,KAAK,WAAW;QAC1B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU;YAC3B,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,4BAA4B,CAAC;IACrC,OAAO,CACL,cAAc,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,IAAI,EAAE;QAC9D,OAAO,UAAU,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,OAMnC;IACC,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,GAAG,OAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,MAG5B;IACC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAChC,OAAO,GAAG,OAAO,cAAc,MAAM,CAAC,IAAI,UAAU,KAAK,EAAE,CAAC;AAC9D,CAAC"}

package/dist/rpc/xsrf-bootstrap.d.ts

@@ -10,8 +10,6 @@ export interface XsrfBootstrapResult {
     sessionId?: string;
     raw: unknown;
 }
-/** Parse xsrf batchexecute response body (even when HTTP status is 400). */
-export declare function parseXsrfResponse(body: string): XsrfBootstrapResult;
 /** Build default batchexecute URL query params for Maps WizUi. */
 export declare function defaultBatchexecuteUrlParams(options: {
     hl?: string;

package/dist/rpc/xsrf-bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xsrf-bootstrap.d.ts","sourceRoot":"","sources":["../../src/rpc/xsrf-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;CACd;AAyBD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAgBnE;AAED,kEAAkE;AAClE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"xsrf-bootstrap.d.ts","sourceRoot":"","sources":["../../src/rpc/xsrf-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;CACd;AA4CD,kEAAkE;AAClE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/rpc/xsrf-bootstrap.js

@@ -4,7 +4,7 @@
  * Maps anonymous HTML often has empty SNlM0e — xsrf is the first batchexecute call
  * the browser makes to obtain a session token when one is returned.
  */
-import { parseChunkedResponse } from '../utils/chunked-decoder.js';
+import { parseChunkedResponse } from '../utils/payload.js';
 import { RPC_INFRA } from './rpc-methods.js';
 import { GMapsError } from '../types/common.js';
 function extractTokenFromXsrfData(data) {
@@ -34,7 +34,7 @@ function extractTokenFromXsrfData(data) {
     return undefined;
 }
 /** Parse xsrf batchexecute response body (even when HTTP status is 400). */
-export function parseXsrfResponse(body) {
+function parseXsrfResponse(body) {
     const trimmed = body.trim();
     if (trimmed.includes('["er"')) {
         throw new GMapsError('xsrf batchexecute returned application error frame');

package/dist/rpc/xsrf-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"xsrf-bootstrap.js","sourceRoot":"","sources":["../../src/rpc/xsrf-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQhD,SAAS,wBAAwB,CAAC,IAAa;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC;YACnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACnC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,SAAS,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,GAAG,EAAE,IAAI,CAAC,IAAI;KACf,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,4BAA4B,CAAC,OAM5C;IACC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;QACtB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;QACtB,EAAE,EAAE,GAAG;QACP,aAAa,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO;QAC5C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"xsrf-bootstrap.js","sourceRoot":"","sources":["../../src/rpc/xsrf-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQhD,SAAS,wBAAwB,CAAC,IAAa;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC;YACnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACnC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,SAAS,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,GAAG,EAAE,IAAI,CAAC,IAAI;KACf,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,4BAA4B,CAAC,OAM5C;IACC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;QACtB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;QACtB,EAAE,EAAE,GAAG;QACP,aAAa,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO;QAC5C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/services/ask-maps.d.ts

@@ -16,6 +16,14 @@
  */
 import { HttpClient } from '../client/http-client.js';
 import { type Coordinates, type GMapsConfig } from '../types/common.js';
+import type { PlaceIdentifiers } from '../types/place-extended.js';
+/**
+ * Agent variants Maps offers, from the client's own model table.
+ *
+ * `mars` is what the web client sends by default. The two `-dev-` ids are
+ * flagged internal-only in that table and are listed for completeness.
+ */
+export type AskMapsModel = 'mars' | 'mars-p13n' | 'mars-p13n-dev-a' | 'mars-p13n-dev-b';
 export interface AskMapsOptions {
     /** Natural-language query, e.g. "best vegetarian restaurants near HSR". */
     query: string;
@@ -24,16 +32,31 @@ export interface AskMapsOptions {
     zoom?: number;
     /** Opaque conversation / thread id when continuing a chat. */
     threadId?: string;
+    /** Agent variant; defaults to `mars`, the web client's own default. */
+    model?: AskMapsModel;
 }
-export interface AskMapsPlaceRef {
+export interface AskMapsPlaceRef extends PlaceIdentifiers {
     name?: string;
-    hexId?: string;
-    placeId?: string;
+    ownerId?: string;
+    address?: string;
+    neighborhood?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    countryCode?: string;
     lat?: number;
     lng?: number;
     rating?: number;
+    reviewCount?: number;
+    category?: string;
+    categories?: string[];
+    raw?: unknown;
 }
 export interface AskMapsResult {
+    /** Conversation id, echoed as the first element of every streamed chunk. */
+    threadId?: string;
+    /** Status labels the agent emits while it works ("Thinking...", ...). */
+    progress: string[];
     /** Free-text answer chunks from the agent (when present). */
     text: string[];
     /** Places the agent cited, when parseable. */
@@ -59,10 +82,27 @@ export interface MapsAiCapability {
 }
 export declare const MAPS_AI_CAPABILITIES: MapsAiCapability[];
 /**
- * Build CallAskMapsAgent args from the Maps JS `yXd` request layout:
- * R7b{1: context(81), 2: Q7b{2: P7b{1: [O7b{query}]}, 3?: viewport}}.
+ * Build CallAskMapsAgent args.
+ *
+ * Mirrors the client's own request builder: a `ClientRequestMetadata` at
+ * field 1 tagged with client 81, then an input message at field 2 holding the
+ * query (field 2, first repeated turn), a context block carrying the camera
+ * (field 3), the model selection (field 4) and the same camera again at
+ * fields 7 and 9 — the agent reads viewport from all three.
  */
 export declare function buildAskMapsArgs(options: AskMapsOptions): unknown[];
+/**
+ * Pull the answer text out of a streamed Ask Maps chunk.
+ *
+ * Chunk shape, from the client's own recorded fixtures:
+ * `[[threadId, {"1000": [[[ …, [[[null,null,null,"text"]]] ]]] }]]` with the
+ * text at event slot 8 and progress labels at slot 21.
+ */
+export declare function extractStreamChunks(root: unknown): {
+    threadId?: string;
+    text: string[];
+    progress: string[];
+};
 export declare class AskMapsService {
     private readonly http;
     private readonly config;

package/dist/services/ask-maps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-maps.d.ts","sourceRoot":"","sources":["../../src/services/ask-maps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,kGAK1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,uBAAuB,GAAG,iBAAiB,GAAG,WAAW,CAAC;IACnE,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EA4ClD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,EAAE,CAcnE;AAmDD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,WAAW;IAGtC,gEAAgE;IAChE,gBAAgB,IAAI,gBAAgB,EAAE;IAItC;;;OAGG;IACH,sBAAsB,CAAC,QAAQ,EAAE;QAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;KAChC,GAAG,KAAK;IAUT;;;;;OAKG;IACG,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0C1D,iDAAiD;IAC3C,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAiB5D"}
+{"version":3,"file":"ask-maps.d.ts","sourceRoot":"","sources":["../../src/services/ask-maps.ts"],"names":[],"mappings":"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"}

package/dist/services/ask-maps.js

@@ -16,8 +16,31 @@
  */
 import { createRpcClient, isBatchErrorCode, parseBatchPayload } from '../rpc/batch-rpc.js';
 import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { extractPlaceIdentifiers, extractStructuredAddress } from '../parsers/place-extended.js';
 import { GMapsAuthError, GMapsError, } from '../types/common.js';
-import { safeGet } from '../utils/safe-get.js';
+import { safeGet } from '../utils/payload.js';
+function extractHistoryThreads(root) {
+    const threads = [];
+    const walk = (node, depth = 0) => {
+        if (depth > 8 || !Array.isArray(node))
+            return;
+        const id = safeGet(node, 0);
+        const title = safeGet(node, 1);
+        if (typeof id === 'string' && id.length > 0) {
+            threads.push({
+                id,
+                title: typeof title === 'string' ? title : undefined,
+                raw: node,
+            });
+        }
+        for (const child of node.slice(0, 20)) {
+            if (Array.isArray(child))
+                walk(child, depth + 1);
+        }
+    };
+    walk(root);
+    return threads;
+}
 /** Official Places API (New) AI field masks — not served on consumer Maps preview. */
 export const PLATFORM_AI_FIELD_MASKS = [
     'generativeSummary',
@@ -70,22 +93,97 @@ export const MAPS_AI_CAPABILITIES = [
     },
 ];
 /**
- * Build CallAskMapsAgent args from the Maps JS `yXd` request layout:
- * R7b{1: context(81), 2: Q7b{2: P7b{1: [O7b{query}]}, 3?: viewport}}.
+ * Agent variant enum values, as the client's model table assigns them.
+ *
+ * The table pairs each id with the number it puts in the request's model
+ * field: `mars` is 4, `mars-p13n` is 3, and the two eval builds are 6 and 7.
+ */
+const ASK_MAPS_MODEL_IDS = {
+    mars: 4,
+    'mars-p13n': 3,
+    'mars-p13n-dev-a': 6,
+    'mars-p13n-dev-b': 7,
+};
+/**
+ * Build CallAskMapsAgent args.
+ *
+ * Mirrors the client's own request builder: a `ClientRequestMetadata` at
+ * field 1 tagged with client 81, then an input message at field 2 holding the
+ * query (field 2, first repeated turn), a context block carrying the camera
+ * (field 3), the model selection (field 4) and the same camera again at
+ * fields 7 and 9 — the agent reads viewport from all three.
  */
 export function buildAskMapsArgs(options) {
     const query = options.query.trim();
-    const o7b = [null, query];
-    const p7b = [null, [o7b]];
-    const viewport = options.location != null
-        ? [null, null, [options.location.lat, options.location.lng, options.zoom ?? 14]]
+    const modelId = ASK_MAPS_MODEL_IDS[options.model ?? 'mars'];
+    // r8b: repeated turn at field 1, each a oneof whose first slot is the text.
+    const turns = [[[query]]];
+    const camera = options.location != null
+        ? [
+            [null, options.location.lng, options.location.lat],
+            [0, 0, 0],
+            [1440, 757],
+            options.zoom ?? 14,
+        ]
         : null;
-    const q7b = [null, null, p7b, viewport];
-    const r7b = [[null, 81], q7b];
+    const input = [
+        null,
+        turns,
+        camera ? [null, null, camera] : null,
+        [[modelId]],
+        null,
+        null,
+        camera ? [camera] : null,
+        null,
+        camera ? [camera] : null,
+    ];
+    const request = [[null, null, null, null, null, null, 81], input];
     if (options.threadId) {
-        return [[options.threadId, r7b]];
+        return [[options.threadId, request]];
     }
-    return [r7b];
+    return [request];
+}
+/**
+ * Pull the answer text out of a streamed Ask Maps chunk.
+ *
+ * Chunk shape, from the client's own recorded fixtures:
+ * `[[threadId, {"1000": [[[ …, [[[null,null,null,"text"]]] ]]] }]]` with the
+ * text at event slot 8 and progress labels at slot 21.
+ */
+export function extractStreamChunks(root) {
+    const text = [];
+    const progress = [];
+    let threadId;
+    const chunks = Array.isArray(root) ? root : [];
+    for (const chunk of chunks) {
+        if (!Array.isArray(chunk))
+            continue;
+        const id = chunk[0];
+        if (typeof id === 'string' && !threadId)
+            threadId = id;
+        const events = chunk[1];
+        if (!events || typeof events !== 'object')
+            continue;
+        for (const group of Object.values(events)) {
+            if (!Array.isArray(group))
+                continue;
+            for (const outer of group) {
+                if (!Array.isArray(outer))
+                    continue;
+                for (const event of outer) {
+                    if (!Array.isArray(event))
+                        continue;
+                    const answer = safeGet(event, 8, 0, 0, 3);
+                    if (typeof answer === 'string' && answer.length > 0)
+                        text.push(answer);
+                    const label = safeGet(event, 21, 0, 0, 0);
+                    if (typeof label === 'string' && label.length > 0)
+                        progress.push(label);
+                }
+            }
+        }
+    }
+    return { threadId, text, progress };
 }
 function extractAskText(root) {
     const out = [];
@@ -109,20 +207,43 @@ function extractAskText(root) {
 }
 function extractAskPlaces(root) {
     const places = [];
+    const seen = new Set();
     const walk = (node, depth = 0) => {
         if (depth > 10 || !Array.isArray(node))
             return;
         const hex = safeGet(node, 10);
         const name = safeGet(node, 11);
         if (typeof hex === 'string' && hex.includes('0x') && typeof name === 'string' && name.length > 1) {
-            places.push({
-                name,
-                hexId: hex,
-                placeId: safeGet(node, 78),
-                lat: safeGet(node, 9, 2),
-                lng: safeGet(node, 9, 3),
-                rating: safeGet(node, 4, 7),
-            });
+            const { cid, kgmid, ownerId } = extractPlaceIdentifiers(node);
+            const address = safeGet(node, 18);
+            const structuredAddress = extractStructuredAddress(node, address);
+            const categories = safeGet(node, 13)?.filter((value) => typeof value === 'string' && value.length > 0);
+            const key = safeGet(node, 78) ?? hex;
+            if (!seen.has(key)) {
+                seen.add(key);
+                places.push({
+                    name,
+                    hexId: hex,
+                    placeId: safeGet(node, 78),
+                    cid,
+                    kgmid,
+                    ownerId,
+                    ftid: safeGet(node, 89),
+                    address,
+                    neighborhood: structuredAddress.neighborhood,
+                    city: structuredAddress.city,
+                    state: structuredAddress.state,
+                    postalCode: structuredAddress.postalCode,
+                    countryCode: structuredAddress.countryCode,
+                    lat: safeGet(node, 9, 2),
+                    lng: safeGet(node, 9, 3),
+                    rating: safeGet(node, 4, 7),
+                    reviewCount: safeGet(node, 4, 8),
+                    category: categories?.[0],
+                    categories,
+                    raw: node,
+                });
+            }
         }
         for (const child of node.slice(0, 30)) {
             if (Array.isArray(child))
@@ -191,8 +312,13 @@ export class AskMapsService {
             }
             throw new GMapsError(`Ask Maps batchexecute error [${String(code)}]`, 200);
         }
+        const stream = extractStreamChunks(root);
         return {
-            text: extractAskText(root),
+            threadId: stream.threadId,
+            progress: [...new Set(stream.progress)],
+            // The schema-aware read wins when the payload is a stream of chunks;
+            // otherwise fall back to scavenging long strings out of the tree.
+            text: stream.text.length > 0 ? stream.text : extractAskText(root),
             places: extractAskPlaces(root),
             raw: root,
             timingMs,
@@ -207,7 +333,8 @@ export class AskMapsService {
             if (isBatchErrorCode(root)) {
                 authRequired('Ask Maps history requires a signed-in Maps session (set GMAPS_COOKIES)');
             }
-            return [{ raw: root }];
+            const threads = extractHistoryThreads(root);
+            return threads.length > 0 ? threads : [{ raw: root }];
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);

package/dist/services/ask-maps.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-maps.js","sourceRoot":"","sources":["../../src/services/ask-maps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ask-maps.js","sourceRoot":"","sources":["../../src/services/ask-maps.ts"],"names":[],"mappings":"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"}

package/dist/services/directions.d.ts

@@ -1,5 +1,6 @@
 import { HttpClient } from '../client/http-client.js';
-import type { DirectionsOptions, DirectionsResult, GMapsConfig } from '../types/common.js';
+import type { Coordinates, DirectionsResult, GMapsConfig } from '../types/common.js';
+import type { DirectionsOptions } from '../types/directions.js';
 export interface DirectionsGetOptions extends DirectionsOptions {
 }
 export declare class DirectionsService {
@@ -7,12 +8,27 @@ export declare class DirectionsService {
     private hl;
     private gl;
     constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Page `ei` token for the directions pb.
+     *
+     * Transit routes are gated on it; the other modes ignore it. Failure to mint
+     * one is not fatal — the request still returns non-transit routes.
+     */
+    sessionToken(anchor?: Coordinates): Promise<string | undefined>;
     /**
      * Fetch driving/walking directions via `/maps/preview/directions`.
      * Coordinates resolve in one round trip; address strings may need an extra resolve step.
      * Pass `includeSteps: true` for turn-by-turn steps when they are not in the preview payload.
      */
     get(options: DirectionsGetOptions): Promise<DirectionsResult>;
+    /**
+     * Fetch alternative routes for directions.
+     * Returns multiple route options sorted by travel time.
+     * Respects alternatives count limit when specified (default: all available).
+     */
+    getAlternatives(options: DirectionsGetOptions & {
+        alternatives?: number;
+    }): Promise<DirectionsResult['routes']>;
     private hasMetrics;
     private isBetterResult;
     private hasTurnByTurn;

package/dist/services/directions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directions.d.ts","sourceRoot":"","sources":["../../src/services/directions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAe,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIxG,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;CAAG;AA8BlE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuDnE,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;YAIP,mBAAmB;CAkBlC"}
+{"version":3,"file":"directions.d.ts","sourceRoot":"","sources":["../../src/services/directions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhE,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;CAAG;AA8BlE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;;OAKG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQrE;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+DnE;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,oBAAoB,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAOtC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;YAIP,mBAAmB;CAkBlC"}