googlemaps-kit 0.1.0

package/dist/services/links.js

@@ -0,0 +1,145 @@
+import { isShortMapsLink, parseMapsUrl } from '../parsers/maps-url.js';
+import { bootstrapSession, buildBrowserHeaders, cookiesToHeader, } from '../auth/session.js';
+import { GMapsError } from '../types/common.js';
+const MAPS_URL_RE = /^https:\/\/(www\.)?google\.[a-z.]+\/maps(\/|$|\?)/i;
+/**
+ * Resolve short links and parse Maps URLs into structured identifiers.
+ *
+ * Short-link expansion uses browser document headers and `?_imcp=1` because
+ * maps.app.goo.gl otherwise serves an interstitial instead of redirecting.
+ */
+export class LinksService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Follow redirect chains (and HTML canonical URLs) until a full google.com/maps URL is reached.
+     */
+    async expand(shortUrl) {
+        const fetchUrl = normalizeShortLinkUrl(shortUrl.trim());
+        const session = await bootstrapSession();
+        const headers = buildBrowserHeaders({
+            userAgent: session.userAgent,
+            cookies: session.cookies,
+            mode: 'document',
+        });
+        let current = fetchUrl;
+        for (let hop = 0; hop < 12; hop++) {
+            const response = await fetch(current, {
+                headers: { ...headers, Cookie: cookiesToHeader(session.cookies) },
+                redirect: 'manual',
+            });
+            if (response.status >= 300 && response.status < 400) {
+                const location = response.headers.get('location');
+                if (!location)
+                    break;
+                current = new URL(location, current).toString();
+                if (isResolvedMapsUrl(current)) {
+                    return stripTrackingParams(current);
+                }
+                continue;
+            }
+            const finalFromResponse = response.url;
+            if (isResolvedMapsUrl(finalFromResponse)) {
+                return stripTrackingParams(finalFromResponse);
+            }
+            const html = await response.text();
+            const fromHtml = extractMapsUrlFromHtml(html, current);
+            if (fromHtml) {
+                return stripTrackingParams(fromHtml);
+            }
+            if (isResolvedMapsUrl(current)) {
+                return stripTrackingParams(current);
+            }
+            break;
+        }
+        throw new GMapsError(`Could not expand short link to a Maps URL: ${shortUrl}`);
+    }
+    /** Expand short links when needed, then parse into a {@link ParsedMapsUrl}. */
+    async resolve(url) {
+        const trimmed = url.trim();
+        if (isShortMapsLink(trimmed)) {
+            const expanded = await this.expand(trimmed);
+            return parseMapsUrl(expanded);
+        }
+        return parseMapsUrl(trimmed);
+    }
+}
+function normalizeShortLinkUrl(input) {
+    let url = input;
+    if (!/^https?:\/\//i.test(url)) {
+        url = `https://${url}`;
+    }
+    const parsed = new URL(url);
+    if (!parsed.searchParams.has('_imcp')) {
+        parsed.searchParams.set('_imcp', '1');
+    }
+    return parsed.toString();
+}
+function isResolvedMapsUrl(url) {
+    if (!MAPS_URL_RE.test(url))
+        return false;
+    try {
+        const parsed = parseMapsUrl(url);
+        return parsed.kind !== 'shortLink' && parsed.kind !== 'unknown';
+    }
+    catch {
+        return MAPS_URL_RE.test(url);
+    }
+}
+function stripTrackingParams(url) {
+    try {
+        const parsed = new URL(url);
+        for (const key of ['_imcp', '_iipp', 'entry', 'g_st']) {
+            parsed.searchParams.delete(key);
+        }
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+function extractMapsUrlFromHtml(html, baseUrl) {
+    const patterns = [
+        /data-desktop-link="([^"]+)"/,
+        /<link[^>]+rel="canonical"[^>]+href="([^"]+)"/,
+        /<link[^>]+href="([^"]+)"[^>]+rel="canonical"/,
+        /property="og:url"\s+content="([^"]+)"/,
+        /content="([^"]+)"\s+property="og:url"/,
+        /"(https:\/\/www\.google\.[^"]+\/maps[^"]+)"/,
+        /"(https:\/\/maps\.google\.[^"]+\/maps[^"]+)"/,
+        /href="(\/maps\/[^"]+)"/,
+    ];
+    for (const pattern of patterns) {
+        const match = html.match(pattern);
+        if (!match?.[1])
+            continue;
+        let candidate = match[1].replace(/&amp;/g, '&');
+        if (candidate.startsWith('/')) {
+            candidate = new URL(candidate, 'https://www.google.com').toString();
+        }
+        if (MAPS_URL_RE.test(candidate) || candidate.includes('/maps/place/') || candidate.includes('/maps/placelists/')) {
+            try {
+                return new URL(candidate, baseUrl).toString();
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    const placeMatch = html.match(/\/maps\/place\/[^"'\\]+/);
+    if (placeMatch) {
+        return `https://www.google.com${placeMatch[0]}`;
+    }
+    const listMatch = html.match(/\/maps\/placelists\/list\/[a-zA-Z0-9_-]+/);
+    if (listMatch) {
+        return `https://www.google.com${listMatch[0]}`;
+    }
+    return null;
+}
+//# sourceMappingURL=links.js.map

package/dist/services/links.js.map

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

package/dist/services/lists.d.ts

@@ -0,0 +1,20 @@
+import { HttpClient } from '../client/http-client.js';
+import { type GMapsConfig } from '../types/common.js';
+import type { GetListOptions, PlaceList } from '../types/lists.js';
+export declare class ListsService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Fetch and parse a public/shared place list.
+     * Accepts `listId` or `url` in options — resolves short links automatically.
+     */
+    get(options: GetListOptions): Promise<PlaceList>;
+    /**
+     * Resolve a raw list id, placelists URL, or maps.app.goo.gl short link to a list id.
+     * Short links are fetched with `?_imcp=1` so Google redirects to the list page.
+     */
+    resolveListId(urlOrId: string): Promise<string>;
+}
+//# sourceMappingURL=lists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/services/lists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnE,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBtD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBtD"}

package/dist/services/lists.js

@@ -0,0 +1,74 @@
+import { assertListNotErrorEnvelope, extractListIdFromPageHtml, extractPlaceList, parseListIdFromInput, } from '../parsers/lists.js';
+import { buildGetListUrl } from '../rpc/lists-pb.js';
+import { GMapsError } from '../types/common.js';
+export class ListsService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Fetch and parse a public/shared place list.
+     * Accepts `listId` or `url` in options — resolves short links automatically.
+     */
+    async get(options) {
+        const listId = await this.resolveListId(options.listId ?? options.url ?? '');
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        const url = buildGetListUrl({
+            listId,
+            pageSize: options.pageSize,
+            hl,
+            gl,
+        });
+        const data = await this.http.get(url, {
+            referer: shareUrlReferer(listId),
+            includeOrigin: true,
+            allowShortBody: true,
+        });
+        assertListNotErrorEnvelope(data);
+        return extractPlaceList(data, { raw: options.raw });
+    }
+    /**
+     * Resolve a raw list id, placelists URL, or maps.app.goo.gl short link to a list id.
+     * Short links are fetched with `?_imcp=1` so Google redirects to the list page.
+     */
+    async resolveListId(urlOrId) {
+        const trimmed = urlOrId.trim();
+        if (!trimmed) {
+            throw new GMapsError('List id or URL is required');
+        }
+        const direct = parseListIdFromInput(trimmed);
+        if (direct)
+            return direct;
+        const fetchUrl = normalizeShortLinkUrl(trimmed);
+        const html = await this.http.get(fetchUrl, {
+            referer: 'https://www.google.com/maps/',
+            raw: true,
+            allowShortBody: true,
+        });
+        const listId = extractListIdFromPageHtml(html, fetchUrl);
+        if (!listId) {
+            throw new GMapsError(`Could not resolve place list id from: ${trimmed}`);
+        }
+        return listId;
+    }
+}
+function shareUrlReferer(listId) {
+    return `https://www.google.com/maps/placelists/list/${listId}`;
+}
+function normalizeShortLinkUrl(input) {
+    let url = input;
+    if (!/^https?:\/\//i.test(url)) {
+        url = `https://${url}`;
+    }
+    const parsed = new URL(url);
+    if (!parsed.searchParams.has('_imcp')) {
+        parsed.searchParams.set('_imcp', '1');
+    }
+    return parsed.toString();
+}
+//# sourceMappingURL=lists.js.map

package/dist/services/lists.js.map

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

package/dist/services/local-posts.d.ts

@@ -0,0 +1,14 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig, LocalPost } from '../types/common.js';
+export interface GetLocalPostsOptions {
+    hexId: string;
+    ftid?: string;
+}
+export declare class LocalPostsService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    list(options: GetLocalPostsOptions): Promise<LocalPost[]>;
+}
+//# sourceMappingURL=local-posts.d.ts.map

package/dist/services/local-posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-posts.d.ts","sourceRoot":"","sources":["../../src/services/local-posts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,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;IAM3C,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAmBhE"}

package/dist/services/local-posts.js

@@ -0,0 +1,32 @@
+import { extractLocalPosts } from '../parsers/local-posts.js';
+import { buildLocalPostsUrl } from '../rpc/pb-builders.js';
+export class LocalPostsService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    async list(options) {
+        const url = buildLocalPostsUrl({
+            hexId: options.hexId,
+            ftid: options.ftid,
+            hl: this.hl,
+            gl: this.gl,
+        });
+        try {
+            const data = await this.http.get(url, {
+                referer: 'https://www.google.com/maps/',
+                includeOrigin: true,
+                allowShortBody: true,
+            });
+            return extractLocalPosts(data);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=local-posts.js.map

package/dist/services/local-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-posts.js","sourceRoot":"","sources":["../../src/services/local-posts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQ3D,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA6B;QACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC;YAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpC,OAAO,EAAE,8BAA8B;gBACvC,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;aACrB,CAAC,CAAC;YACH,OAAO,iBAAiB,CAAC,IAA6C,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/services/panorama.d.ts

@@ -0,0 +1,39 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { PanoramaGetOptions, PanoramaImageOptions, PanoramaLocationOptions, PanoramaMetadata, PanoramaRef, PanoramaSearchOptions } from '../types/panorama.js';
+export declare class PanoramaService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Find Street View panoramas near a point, closest first.
+     *
+     * Coverage tiles are tried first: `listentityphotos` is abuse throttled (sustained use
+     * earns HTML 403s) and pads its results with user photos and session tokens, while a
+     * coverage tile returns only official panoramas with coordinates. listentityphotos is
+     * kept as a fallback because it is the only source of Google-hosted thumbnails.
+     */
+    findNearby(options: PanoramaSearchOptions): Promise<PanoramaRef[]>;
+    /** Coverage-tile lookup, expanding to the 3×3 tile block when the centre is empty. */
+    private findViaCoverage;
+    /** Fallback lookup that also yields Google-hosted thumbnails. */
+    private findViaEntityPhotos;
+    /**
+     * Order candidates by proximity, keeping those without coordinates as a last resort.
+     *
+     * A tile covers more ground than the requested radius, so unfiltered results can sit
+     * hundreds of metres away; but discarding every out-of-radius hit would return nothing
+     * in sparsely covered areas, so they are kept behind the in-radius ones.
+     */
+    private rankByDistance;
+    /** Fetch full metadata for a panorama id; null when Google returns the stub response. */
+    get(panoId: string, options?: PanoramaGetOptions): Promise<PanoramaMetadata | null>;
+    /** Resolve the closest panorama near a point, then fetch its full metadata. */
+    getByLocation(lat: number, lng: number, options?: PanoramaLocationOptions): Promise<PanoramaMetadata | null>;
+    /** Build a Street View thumbnail URL (no network I/O). */
+    buildThumbnailUrl(options: PanoramaImageOptions): string;
+    /** Build a Street View tile URL (no network I/O). */
+    buildTileUrl(options: PanoramaImageOptions): string;
+}
+//# sourceMappingURL=panorama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panorama.d.ts","sourceRoot":"","sources":["../../src/services/panorama.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAatD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAkB9B,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWxE,sFAAsF;YACxE,eAAe;IAgD7B,iEAAiE;YACnD,mBAAmB;IAgCjC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAoBtB,yFAAyF;IACnF,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAenC,+EAA+E;IACzE,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuBnC,0DAA0D;IAC1D,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAUxD,qDAAqD;IACrD,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;CAQpD"}

package/dist/services/panorama.js

@@ -0,0 +1,175 @@
+import { extractCoveragePanoramas, extractNearbyPanoramas, extractPanoramaMetadata, } from '../parsers/panorama.js';
+import { buildCoverageTileUrl, buildListEntityPhotosUrl, buildPhotometaUrl, buildThumbnailUrl, buildTileUrl, } from '../rpc/panorama-pb.js';
+import { GMapsNetworkError, GMapsPhotosBlockedError } from '../types/common.js';
+import { haversineMeters, webMercatorTile } from '../utils/geo.js';
+const DEFAULT_RADIUS_METERS = 300;
+/** Coverage tiles only answer at zoom 17 — zoom 18 returns HTTP 400. */
+const COVERAGE_ZOOM = 17;
+/** A z17 tile spans roughly this far, so wider searches need the neighbouring tiles. */
+const COVERAGE_TILE_SPAN_METERS = 305;
+/** Street View pano ids from listentityphotos — excludes session tokens and numeric photo ids. */
+function isLikelyStreetViewPanoId(panoId) {
+    if (panoId.startsWith('0ahUKE'))
+        return false;
+    if (/^\d+$/.test(panoId))
+        return false;
+    return /^[A-Za-z0-9_-]{16,44}$/.test(panoId);
+}
+export class PanoramaService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Find Street View panoramas near a point, closest first.
+     *
+     * Coverage tiles are tried first: `listentityphotos` is abuse throttled (sustained use
+     * earns HTML 403s) and pads its results with user photos and session tokens, while a
+     * coverage tile returns only official panoramas with coordinates. listentityphotos is
+     * kept as a fallback because it is the only source of Google-hosted thumbnails.
+     */
+    async findNearby(options) {
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        const radiusMeters = options.radiusMeters ?? DEFAULT_RADIUS_METERS;
+        const fromCoverage = await this.findViaCoverage(options.lat, options.lng, radiusMeters, hl, gl);
+        if (fromCoverage.length > 0)
+            return fromCoverage;
+        return this.findViaEntityPhotos(options.lat, options.lng, radiusMeters, hl, gl);
+    }
+    /** Coverage-tile lookup, expanding to the 3×3 tile block when the centre is empty. */
+    async findViaCoverage(lat, lng, radiusMeters, hl, gl) {
+        const centre = webMercatorTile(lat, lng, COVERAGE_ZOOM);
+        const offsets = radiusMeters > COVERAGE_TILE_SPAN_METERS / 2
+            ? [
+                [0, 0],
+                [-1, 0],
+                [1, 0],
+                [0, -1],
+                [0, 1],
+                [-1, -1],
+                [-1, 1],
+                [1, -1],
+                [1, 1],
+            ]
+            : [[0, 0]];
+        const seen = new Set();
+        const collected = [];
+        for (const [dx, dy] of offsets) {
+            let refs;
+            try {
+                const data = await this.http.get(buildCoverageTileUrl({ tileX: centre.x + dx, tileY: centre.y + dy, hl, gl }), { referer: 'https://www.google.com/maps/', includeOrigin: true, allowShortBody: true });
+                refs = extractCoveragePanoramas(data);
+            }
+            catch {
+                continue;
+            }
+            for (const ref of refs) {
+                if (seen.has(ref.panoId))
+                    continue;
+                seen.add(ref.panoId);
+                collected.push(ref);
+            }
+        }
+        return this.rankByDistance(collected, lat, lng, radiusMeters);
+    }
+    /** Fallback lookup that also yields Google-hosted thumbnails. */
+    async findViaEntityPhotos(lat, lng, radiusMeters, hl, gl) {
+        const url = buildListEntityPhotosUrl({ lat, lng, radiusMeters, hl, gl });
+        const requestOpts = {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            noRetry: true,
+        };
+        let data;
+        try {
+            data = await this.http.get(url, requestOpts);
+        }
+        catch (error) {
+            if (error instanceof GMapsPhotosBlockedError)
+                throw error;
+            if (error instanceof GMapsNetworkError && error.message.includes('403')) {
+                throw new GMapsPhotosBlockedError(undefined, error.message);
+            }
+            throw error;
+        }
+        const refs = extractNearbyPanoramas(data).filter((ref) => isLikelyStreetViewPanoId(ref.panoId));
+        return this.rankByDistance(refs, lat, lng, radiusMeters);
+    }
+    /**
+     * Order candidates by proximity, keeping those without coordinates as a last resort.
+     *
+     * A tile covers more ground than the requested radius, so unfiltered results can sit
+     * hundreds of metres away; but discarding every out-of-radius hit would return nothing
+     * in sparsely covered areas, so they are kept behind the in-radius ones.
+     */
+    rankByDistance(refs, lat, lng, radiusMeters) {
+        const scored = refs.map((ref) => ({
+            ref,
+            distance: ref.lat != null && ref.lng != null
+                ? haversineMeters(lat, lng, ref.lat, ref.lng)
+                : Number.POSITIVE_INFINITY,
+        }));
+        scored.sort((a, b) => a.distance - b.distance);
+        const withinRadius = scored.filter((entry) => entry.distance <= radiusMeters);
+        return (withinRadius.length > 0 ? withinRadius : scored).map((entry) => entry.ref);
+    }
+    /** Fetch full metadata for a panorama id; null when Google returns the stub response. */
+    async get(panoId, options) {
+        const hl = options?.hl ?? this.hl;
+        const gl = options?.gl ?? this.gl;
+        const url = buildPhotometaUrl({ panoId, hl, gl });
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            allowShortBody: true,
+        });
+        return extractPanoramaMetadata(data, { raw: options?.raw });
+    }
+    /** Resolve the closest panorama near a point, then fetch its full metadata. */
+    async getByLocation(lat, lng, options) {
+        const nearby = await this.findNearby({
+            lat,
+            lng,
+            radiusMeters: options?.radiusMeters,
+            hl: options?.hl,
+            gl: options?.gl,
+        });
+        const candidates = nearby.filter((ref) => isLikelyStreetViewPanoId(ref.panoId));
+        for (const ref of candidates.slice(0, 10)) {
+            try {
+                const meta = await this.get(ref.panoId, options);
+                if (meta)
+                    return meta;
+            }
+            catch {
+                // Not every discovered id resolves on photometa — try the next closest.
+            }
+        }
+        return null;
+    }
+    /** Build a Street View thumbnail URL (no network I/O). */
+    buildThumbnailUrl(options) {
+        return buildThumbnailUrl({
+            panoId: options.panoId,
+            width: options.width,
+            height: options.height,
+            pitch: options.pitch,
+            yaw: options.yaw,
+        });
+    }
+    /** Build a Street View tile URL (no network I/O). */
+    buildTileUrl(options) {
+        return buildTileUrl({
+            panoId: options.panoId,
+            x: options.x,
+            y: options.y,
+            zoom: options.zoom,
+        });
+    }
+}
+//# sourceMappingURL=panorama.js.map

package/dist/services/panorama.js.map

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

package/dist/services/passiveassist.d.ts

@@ -0,0 +1,21 @@
+import { HttpClient } from '../client/http-client.js';
+import { type GMapsConfig } from '../types/common.js';
+import type { PassiveAssistOptions, PassiveAssistResult } from '../types/passiveassist.js';
+export declare class PassiveAssistService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Viewport POI chips for the map camera (weather, events, neighbourhood labels).
+     *
+     * Needs an in-page viewport psi: bootstrap kEI / fetchSessionPsi tokens return
+     * the ~212 B cache-metadata stub, and only a token from a live viewport
+     * passiveassist request yields chips. Such a token is portable — it replays over
+     * plain Node fetch and stays valid for at least a few minutes — but minting one
+     * requires a browser, so pass `psi` yourself or supply a `psiProvider`. This
+     * service will not start a browser on your behalf.
+     */
+    getViewportChips(options: PassiveAssistOptions): Promise<PassiveAssistResult>;
+}
+//# sourceMappingURL=passiveassist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"passiveassist.d.ts","sourceRoot":"","sources":["../../src/services/passiveassist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAG3F,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;;;;;;OASG;IACG,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoDpF"}

package/dist/services/passiveassist.js

@@ -0,0 +1,70 @@
+import { extractPassiveAssistChips } from '../parsers/passiveassist.js';
+import { buildPassiveAssistUrl } from '../rpc/passiveassist-pb.js';
+import { GMapsError } from '../types/common.js';
+export class PassiveAssistService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Viewport POI chips for the map camera (weather, events, neighbourhood labels).
+     *
+     * Needs an in-page viewport psi: bootstrap kEI / fetchSessionPsi tokens return
+     * the ~212 B cache-metadata stub, and only a token from a live viewport
+     * passiveassist request yields chips. Such a token is portable — it replays over
+     * plain Node fetch and stays valid for at least a few minutes — but minting one
+     * requires a browser, so pass `psi` yourself or supply a `psiProvider`. This
+     * service will not start a browser on your behalf.
+     */
+    async getViewportChips(options) {
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        let psi = options.psi;
+        let url;
+        if (!psi && options.psiProvider) {
+            const minted = await options.psiProvider({
+                lat: options.lat,
+                lng: options.lng,
+                zoom: options.zoom,
+                hl,
+                gl,
+            });
+            if (typeof minted === 'string') {
+                psi = minted;
+            }
+            else {
+                psi = minted.psi;
+                url = minted.passiveAssistUrl;
+            }
+        }
+        if (!psi) {
+            throw new GMapsError('passiveassist needs an in-page viewport psi: pass `psi`, or a `psiProvider` ' +
+                '(see mintViewportPsi in scripts/lib/mint-viewport-psi.ts, which uses a headless browser). ' +
+                'Bootstrap tokens only return the cache-metadata stub.');
+        }
+        if (!url) {
+            url = buildPassiveAssistUrl({
+                lat: options.lat,
+                lng: options.lng,
+                zoom: options.zoom,
+                psi,
+                width: options.width,
+                height: options.height,
+                chipLimit: options.chipLimit,
+                hl,
+                gl,
+            });
+        }
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            allowShortBody: true,
+        });
+        return extractPassiveAssistChips(data);
+    }
+}
+//# sourceMappingURL=passiveassist.js.map

package/dist/services/passiveassist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passiveassist.js","sourceRoot":"","sources":["../../src/services/passiveassist.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAIlE,MAAM,OAAO,oBAAoB;IACvB,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAA6B;QAClD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACtB,IAAI,GAAuB,CAAC;QAE5B,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC;gBACvC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,EAAE;gBACF,EAAE;aACH,CAAC,CAAC;YACH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,GAAG,GAAG,MAAM,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;gBACjB,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAChC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,UAAU,CAClB,8EAA8E;gBAC5E,4FAA4F;gBAC5F,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,qBAAqB,CAAC;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,GAAG;gBACH,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,EAAE;gBACF,EAAE;aACH,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,OAAO,EAAE,8BAA8B;YACvC,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}