googlemaps-kit 0.1.0

package/dist/services/ask-maps.js

@@ -0,0 +1,221 @@
+/**
+ * Ask Maps + Maps AI surfaces.
+ *
+ * Consumer Maps:
+ *   - MapsAiAgentService.CallAskMapsAgent (rpcid EGR9cd) — Gemini conversational search
+ *   - MapsAskMapsHistoryService.* — thread history (signed-in)
+ *   - MapsGenAiSearchService.SubmitUserFeedback — telemetry only
+ *
+ * Places API (New) AI field masks are Platform-only (API key). They do **not** appear in
+ * anonymous consumer place-preview payloads:
+ *   generativeSummary | reviewSummary | neighborhoodSummary | evChargeAmenitySummary
+ *
+ * Desktop Maps often shows “Ask Maps is coming soon” and routes users to mobile; anonymous
+ * batchexecute returns HTTP 500 for every probed arg shape. Signed-in cookies
+ * (`GMAPS_COOKIES`) are required to exercise the agent.
+ */
+import { createRpcClient, isBatchErrorCode, parseBatchPayload } from '../rpc/batch-rpc.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { GMapsAuthError, GMapsError, } from '../types/common.js';
+import { safeGet } from '../utils/safe-get.js';
+/** Official Places API (New) AI field masks — not served on consumer Maps preview. */
+export const PLATFORM_AI_FIELD_MASKS = [
+    'generativeSummary',
+    'reviewSummary',
+    'neighborhoodSummary',
+    'evChargeAmenitySummary',
+];
+export const MAPS_AI_CAPABILITIES = [
+    {
+        id: 'CallAskMapsAgent',
+        surface: 'consumer-batchexecute',
+        status: 'auth-required',
+        notes: 'MapsAiAgentService.CallAskMapsAgent (EGR9cd). Anonymous → HTTP 500; desktop often gated to mobile.',
+    },
+    {
+        id: 'AskMapsHistory',
+        surface: 'consumer-batchexecute',
+        status: 'auth-required',
+        notes: 'MapsAskMapsHistoryService List/Get/Delete/Share threads — signed-in only.',
+    },
+    {
+        id: 'SubmitUserFeedback',
+        surface: 'telemetry',
+        status: 'telemetry-only',
+        notes: 'MapsGenAiSearchService.SubmitUserFeedback — not a data API.',
+    },
+    {
+        id: 'generativeSummary',
+        surface: 'places-platform',
+        status: 'platform-only',
+        notes: 'Places API (New) field mask; requires Cloud API key. Absent from consumer preview.',
+    },
+    {
+        id: 'reviewSummary',
+        surface: 'places-platform',
+        status: 'platform-only',
+        notes: 'Places API (New) field mask; Gemini review themes. Absent from consumer preview.',
+    },
+    {
+        id: 'neighborhoodSummary',
+        surface: 'places-platform',
+        status: 'platform-only',
+        notes: 'Places API (New) area summary field mask.',
+    },
+    {
+        id: 'evChargeAmenitySummary',
+        surface: 'places-platform',
+        status: 'platform-only',
+        notes: 'Places API (New) EV amenity summary field mask.',
+    },
+];
+/**
+ * Build CallAskMapsAgent args from the Maps JS `yXd` request layout:
+ * R7b{1: context(81), 2: Q7b{2: P7b{1: [O7b{query}]}, 3?: viewport}}.
+ */
+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]]
+        : null;
+    const q7b = [null, null, p7b, viewport];
+    const r7b = [[null, 81], q7b];
+    if (options.threadId) {
+        return [[options.threadId, r7b]];
+    }
+    return [r7b];
+}
+function extractAskText(root) {
+    const out = [];
+    const walk = (node, depth = 0) => {
+        if (depth > 12)
+            return;
+        if (typeof node === 'string' &&
+            node.length > 40 &&
+            !node.startsWith('http') &&
+            !/^[A-Za-z0-9+/=_-]{40,}$/.test(node)) {
+            out.push(node);
+            return;
+        }
+        if (Array.isArray(node)) {
+            for (const child of node.slice(0, 40))
+                walk(child, depth + 1);
+        }
+    };
+    walk(root);
+    return [...new Set(out)].slice(0, 20);
+}
+function extractAskPlaces(root) {
+    const places = [];
+    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),
+            });
+        }
+        for (const child of node.slice(0, 30)) {
+            if (Array.isArray(child))
+                walk(child, depth + 1);
+        }
+    };
+    walk(root);
+    return places;
+}
+function authRequired(message) {
+    throw new GMapsAuthError(message);
+}
+export class AskMapsService {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /** Catalog of Maps AI surfaces (consumer + Places Platform). */
+    listCapabilities() {
+        return MAPS_AI_CAPABILITIES;
+    }
+    /**
+     * Official Places generative / review / neighborhood summaries.
+     * These exist only on `places.googleapis.com` with an API key — not on consumer Maps.
+     */
+    getPlatformAiSummaries(_options) {
+        throw new GMapsError('Places AI summaries (generativeSummary, reviewSummary, neighborhoodSummary, ' +
+            'evChargeAmenitySummary) are Places API (New) field masks only. Consumer Maps ' +
+            'place-preview does not embed them. Use an official API key, or maps.askMaps.ask() ' +
+            'for the signed-in Ask Maps agent.', 501);
+    }
+    /**
+     * Call the Ask Maps agent (CallAskMapsAgent).
+     *
+     * @throws {GMapsAuthError} when the anonymous session is rejected (typical).
+     * @throws {GMapsError} on other batchexecute application errors.
+     */
+    async ask(options) {
+        if (!options.query.trim()) {
+            throw new GMapsError('Ask Maps query must be non-empty');
+        }
+        const rpc = await createRpcClient(this.http, this.config);
+        const start = performance.now();
+        let data;
+        try {
+            data = await rpc.call(BATCH_SERVICES.CALL_ASK_MAPS, buildAskMapsArgs(options));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (/500|401|auth/i.test(message)) {
+                authRequired('Ask Maps (CallAskMapsAgent) requires a signed-in Maps session (set GMAPS_COOKIES). ' +
+                    'Anonymous batchexecute returns HTTP 500 for all probed arg shapes. ' +
+                    'Desktop Maps often shows “Ask Maps is coming soon” and pushes mobile. ' +
+                    'Official Places generativeSummary/reviewSummary are Platform-API-only field masks.');
+            }
+            throw error;
+        }
+        const root = parseBatchPayload(data);
+        const timingMs = performance.now() - start;
+        if (isBatchErrorCode(root)) {
+            const code = Array.isArray(root) ? root[0] : root;
+            if (code === 3 || code === 7 || code === 500) {
+                authRequired(`Ask Maps blocked with error [${String(code)}] — signed-in cookies required`);
+            }
+            throw new GMapsError(`Ask Maps batchexecute error [${String(code)}]`, 200);
+        }
+        return {
+            text: extractAskText(root),
+            places: extractAskPlaces(root),
+            raw: root,
+            timingMs,
+        };
+    }
+    /** List Ask Maps history threads (signed-in). */
+    async listHistoryThreads() {
+        const rpc = await createRpcClient(this.http, this.config);
+        try {
+            const data = await rpc.call(BATCH_SERVICES.LIST_ASK_MAPS_HISTORY, [[[null, 81]]]);
+            const root = parseBatchPayload(data);
+            if (isBatchErrorCode(root)) {
+                authRequired('Ask Maps history requires a signed-in Maps session (set GMAPS_COOKIES)');
+            }
+            return [{ raw: root }];
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (/500|401|auth|\[3\]|\[7\]/i.test(message)) {
+                authRequired('Ask Maps history requires a signed-in Maps session (set GMAPS_COOKIES)');
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=ask-maps.js.map

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

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

package/dist/services/batch-url.d.ts

@@ -0,0 +1,18 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { CreateShortUrlOptions, CreateShortUrlResult, DecodeUrlOptions, DecodedMapsUrl } from '../types/batch-url.js';
+export declare class BatchUrlService {
+    private http;
+    private config;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /** Server-side Maps URL decode (MapsUrlService.DecodeUrl batchexecute). */
+    decode(options: DecodeUrlOptions & {
+        raw?: boolean;
+    }): Promise<DecodedMapsUrl>;
+    /** Create a maps.app.goo.gl short link (may require signed-in session). */
+    createShortUrl(options: CreateShortUrlOptions & {
+        raw?: boolean;
+    }): Promise<CreateShortUrlResult>;
+    private resolvePsi;
+}
+//# sourceMappingURL=batch-url.d.ts.map

package/dist/services/batch-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.d.ts","sourceRoot":"","sources":["../../src/services/batch-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKtD,2EAA2E;IACrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAMpF,2EAA2E;IACrE,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAOzF,UAAU;CAIzB"}

package/dist/services/batch-url.js

@@ -0,0 +1,30 @@
+import { extractCreateShortUrlResult, extractDecodedMapsUrl } from '../parsers/batch-url.js';
+import { buildCreateShortUrlArgs, buildDecodeUrlArgs } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient, fetchPlacePsi } from '../rpc/batch-rpc.js';
+export class BatchUrlService {
+    http;
+    config;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.config = config;
+    }
+    /** Server-side Maps URL decode (MapsUrlService.DecodeUrl batchexecute). */
+    async decode(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.DECODE_URL, buildDecodeUrlArgs(options.url));
+        return extractDecodedMapsUrl(data, options);
+    }
+    /** Create a maps.app.goo.gl short link (may require signed-in session). */
+    async createShortUrl(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const psi = options.psi ?? (await this.resolvePsi());
+        const data = await rpc.call(BATCH_SERVICES.CREATE_SHORT_URL, buildCreateShortUrlArgs(options.url, psi));
+        return extractCreateShortUrlResult(data, options);
+    }
+    async resolvePsi() {
+        const psi = await fetchPlacePsi(this.http, '/maps/place/@12.9168,77.6450,14z');
+        return psi ?? 'anonymous';
+    }
+}
+//# sourceMappingURL=batch-url.js.map

package/dist/services/batch-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.js","sourceRoot":"","sources":["../../src/services/batch-url.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASrE,MAAM,OAAO,eAAe;IAClB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,MAAM,CAAC,OAA6C;QACxD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACxF,OAAO,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,cAAc,CAAC,OAAkD;QACrE,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACxG,OAAO,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,kCAAkC,CAAC,CAAC;QAC/E,OAAO,GAAG,IAAI,WAAW,CAAC;IAC5B,CAAC;CACF"}

package/dist/services/categories.d.ts

@@ -0,0 +1,21 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { CategoryNode, CategorySuggestion, GetCategorySuggestionsOptions, GetPlaceInfoOptions, GetPotentialDuplicatesOptions, GetSignedUrlOptions, PlaceInfoResult, PotentialDuplicate, SignedPlaceUrl } from '../types/categories.js';
+export declare class CategoriesService {
+    private http;
+    private config;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /** Full Maps place category taxonomy (LocalRapService.GetCategoryHierarchy). */
+    getHierarchy(): Promise<CategoryNode[]>;
+    /** Autocomplete category suggestions for a query string. */
+    suggest(options: GetCategorySuggestionsOptions): Promise<CategorySuggestion[]>;
+    /** Resolve hex id metadata for a place feature id. */
+    getPlaceInfo(options: GetPlaceInfoOptions): Promise<PlaceInfoResult>;
+    /** Find potential duplicate listings near/alongside a place. */
+    getPotentialDuplicates(options: GetPotentialDuplicatesOptions & {
+        raw?: boolean;
+    }): Promise<PotentialDuplicate[]>;
+    /** Get a signed hex id path fragment for authenticated place URLs. */
+    getSignedUrl(options: GetSignedUrlOptions): Promise<SignedPlaceUrl | null>;
+}
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/services/categories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAgBtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKtD,gFAAgF;IAC1E,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAM7C,4DAA4D;IACtD,OAAO,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IASpF,sDAAsD;IAChD,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM1E,gEAAgE;IAC1D,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GACzD,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAShC,sEAAsE;IAChE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAKjF"}

package/dist/services/categories.js

@@ -0,0 +1,43 @@
+import { extractCategoryHierarchy, extractCategorySuggestions, extractPlaceInfo, extractPotentialDuplicates, extractSignedPlaceUrl, } from '../parsers/categories.js';
+import { buildCategorySuggestionsArgs, buildPlaceInfoArgs, buildPotentialDuplicatesArgs, buildSignedUrlArgs, } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient } from '../rpc/batch-rpc.js';
+export class CategoriesService {
+    http;
+    config;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.config = config;
+    }
+    /** Full Maps place category taxonomy (LocalRapService.GetCategoryHierarchy). */
+    async getHierarchy() {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.CATEGORY_HIERARCHY, []);
+        return extractCategoryHierarchy(data);
+    }
+    /** Autocomplete category suggestions for a query string. */
+    async suggest(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.CATEGORY_SUGGESTIONS, buildCategorySuggestionsArgs(options.query));
+        return extractCategorySuggestions(data);
+    }
+    /** Resolve hex id metadata for a place feature id. */
+    async getPlaceInfo(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.PLACE_INFO, buildPlaceInfoArgs(options.hexId));
+        return extractPlaceInfo(data);
+    }
+    /** Find potential duplicate listings near/alongside a place. */
+    async getPotentialDuplicates(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.POTENTIAL_DUPLICATES, buildPotentialDuplicatesArgs(options.hexId));
+        return extractPotentialDuplicates(data, options);
+    }
+    /** Get a signed hex id path fragment for authenticated place URLs. */
+    async getSignedUrl(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.SIGNED_URL, buildSignedUrlArgs(options.hexId));
+        return extractSignedPlaceUrl(data);
+    }
+}
+//# sourceMappingURL=categories.js.map

package/dist/services/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/services/categories.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AActD,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACnE,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,OAAO,CAAC,OAAsC;QAClD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,oBAAoB,EACnC,4BAA4B,CAAC,OAAO,CAAC,KAAK,CAAC,CAC5C,CAAC;QACF,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1F,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,sBAAsB,CAC1B,OAA0D;QAE1D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,oBAAoB,EACnC,4BAA4B,CAAC,OAAO,CAAC,KAAK,CAAC,CAC5C,CAAC;QACF,OAAO,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,YAAY,CAAC,OAA4B;QAC7C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1F,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/services/directions.d.ts

@@ -0,0 +1,26 @@
+import { HttpClient } from '../client/http-client.js';
+import type { DirectionsOptions, DirectionsResult, GMapsConfig } from '../types/common.js';
+export interface DirectionsGetOptions extends DirectionsOptions {
+    /**
+     * Skip `/maps/dir/` HTML scrape when the preview pb lacks turn-by-turn steps.
+     * Use for distance-matrix / elevation cells where duration+distance are enough —
+     * saves ~300–800 ms per pair.
+     */
+    metricsOnly?: boolean;
+}
+export declare class DirectionsService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Fetch driving/walking directions via `/maps/preview/directions`.
+     * Uses a built pb first; scrapes the Maps `/dir/` page pb when turn-by-turn steps are missing
+     * (unless `metricsOnly` — then one preview hit is enough for distance/duration).
+     */
+    get(options: DirectionsGetOptions): Promise<DirectionsResult>;
+    private isBetterResult;
+    private hasTurnByTurn;
+    private scrapePbFromDirPage;
+}
+//# sourceMappingURL=directions.d.ts.map

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

@@ -0,0 +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;AAGxG,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAyBD,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;IA6CnE,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;YAIP,mBAAmB;CAalC"}

package/dist/services/directions.js

@@ -0,0 +1,104 @@
+import { extractDirections } from '../parsers/directions.js';
+import { buildDirectionsUrls, directionsDataSuffix } from '../rpc/pb-builders.js';
+function formatDirEndpoint(value) {
+    if (typeof value === 'object') {
+        return `${value.lat},${value.lng}`;
+    }
+    const pipe = value.indexOf('|');
+    if (pipe > 0) {
+        const hexId = value.slice(0, pipe);
+        const name = value.slice(pipe + 1).replace(/\//g, '');
+        return `place/${encodeURIComponent(name)}/@${hexId}`;
+    }
+    return encodeURIComponent(value.replace(/ /g, '+'));
+}
+function buildMapsDirUrl(options) {
+    const segments = [
+        formatDirEndpoint(options.origin),
+        ...(options.waypoints ?? []).map((waypoint) => formatDirEndpoint(waypoint.location)),
+        formatDirEndpoint(options.destination),
+    ];
+    const suffix = directionsDataSuffix(options.mode ?? 'driving');
+    return `https://www.google.com/maps/dir/${segments.join('/')}/${suffix}`;
+}
+export class DirectionsService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Fetch driving/walking directions via `/maps/preview/directions`.
+     * Uses a built pb first; scrapes the Maps `/dir/` page pb when turn-by-turn steps are missing
+     * (unless `metricsOnly` — then one preview hit is enough for distance/duration).
+     */
+    async get(options) {
+        let best = { legs: [] };
+        const tryUrl = async (url) => {
+            try {
+                const data = await this.http.get(url, {
+                    referer: 'https://www.google.com/maps/',
+                    includeOrigin: true,
+                });
+                return extractDirections(data);
+            }
+            catch {
+                return null;
+            }
+        };
+        for (const url of buildDirectionsUrls({ ...options, hl: this.hl, gl: this.gl })) {
+            const parsed = await tryUrl(url);
+            if (!parsed)
+                continue;
+            if (this.isBetterResult(parsed, best))
+                best = parsed;
+            if (options.metricsOnly) {
+                if (parsed.duration || parsed.distance || (parsed.legs[0]?.distance ?? parsed.legs[0]?.duration)) {
+                    return parsed;
+                }
+                continue;
+            }
+            if (this.hasTurnByTurn(parsed))
+                return parsed;
+        }
+        if (options.metricsOnly)
+            return best;
+        const scrapedPb = await this.scrapePbFromDirPage(options);
+        if (scrapedPb) {
+            const url = `https://www.google.com/maps/preview/directions` +
+                `?authuser=0&hl=${this.hl}&gl=${this.gl}` +
+                `&pb=${encodeURIComponent(scrapedPb)}`;
+            const parsed = await tryUrl(url);
+            if (parsed && this.isBetterResult(parsed, best)) {
+                best = parsed;
+            }
+        }
+        return best;
+    }
+    isBetterResult(next, prev) {
+        const nextSteps = next.legs[0]?.steps?.length ?? 0;
+        const prevSteps = prev.legs[0]?.steps?.length ?? 0;
+        return nextSteps > prevSteps || Boolean(next.duration && !prev.duration);
+    }
+    hasTurnByTurn(result) {
+        return (result.legs[0]?.steps?.length ?? 0) > 0 && Boolean(result.duration);
+    }
+    async scrapePbFromDirPage(options) {
+        try {
+            const dirUrl = buildMapsDirUrl(options);
+            const html = await this.http.get(dirUrl, {
+                referer: 'https://www.google.com/maps/',
+                raw: true,
+            });
+            const match = html.match(/preview\/directions[^"']*pb=([^"'&]+)/);
+            return match ? decodeURIComponent(match[1]) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=directions.js.map

package/dist/services/directions.js.map

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

package/dist/services/distance-matrix.d.ts

@@ -0,0 +1,17 @@
+import type { GMapsConfig } from '../types/common.js';
+import type { DistanceMatrixOptions, DistanceMatrixResult } from '../types/distance-matrix.js';
+import { DirectionsService } from './directions.js';
+export declare class DistanceMatrixService {
+    private directions;
+    constructor(directions: DirectionsService, _config: GMapsConfig);
+    /**
+     * Compute an origins × destinations travel-time matrix.
+     *
+     * Consumer Maps has no native Distance Matrix RPC — this fans out over
+     * `/maps/preview/directions` with `metricsOnly` (no HTML scrape). Defaults:
+     * concurrency 8, no artificial per-pair delay. A 2×2 lands near one directions
+     * RTT (~700 ms); larger matrices scale as ceil(N×M / concurrency) × ~RTT.
+     */
+    getMatrix(options: DistanceMatrixOptions): Promise<DistanceMatrixResult>;
+}
+//# sourceMappingURL=distance-matrix.d.ts.map

package/dist/services/distance-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance-matrix.d.ts","sourceRoot":"","sources":["../../src/services/distance-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAGV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAoDpD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAoB;gBAE1B,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW;IAI/D;;;;;;;OAOG;IACG,SAAS,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmH/E"}