googlemaps-kit 0.1.0

package/dist/rpc/maps-url-builders.js

@@ -0,0 +1,266 @@
+/**
+ * Canonical Google Maps share/embed URL builders.
+ *
+ * Inverse of {@link parseMapsUrl} — produces human-facing `google.com/maps/*` URLs,
+ * distinct from the internal RPC pb URLs in `pb-builders.ts`.
+ */
+import { viewportAltitude } from '../utils/static-map-grid.js';
+const BASE = 'https://www.google.com/maps';
+const TRAVEL_MODE_CODE = {
+    driving: 0,
+    bicycling: 1,
+    walking: 2,
+    transit: 3,
+};
+function encodePathSegment(value) {
+    return encodeURIComponent(value).replace(/%20/g, '+');
+}
+function formatCoord(value) {
+    const rounded = Math.round(value * 1e7) / 1e7;
+    return Number.isInteger(rounded) ? String(rounded) : String(rounded);
+}
+function viewportSegment(lat, lng, zoom) {
+    const z = zoom ?? 15;
+    return `@${formatCoord(lat)},${formatCoord(lng)},${z}z`;
+}
+function placeDataBlob(params) {
+    const idPart = params.hexId
+        ? `!1s${params.hexId}`
+        : params.placeId
+            ? `!1s${params.placeId}`
+            : '';
+    const ftidPart = params.featureId
+        ? `!16s${encodeURIComponent(params.featureId.startsWith('/') ? params.featureId : `/${params.featureId}`)}`
+        : '';
+    return (`!3m1!4b1!4m6!3m5${idPart}!8m2!3d${formatCoord(params.lat)}!4d${formatCoord(params.lng)}${ftidPart}`);
+}
+function directionsDataBlob(mode) {
+    const modeCode = mode ? TRAVEL_MODE_CODE[mode] : undefined;
+    return modeCode != null ? `!4m2!4m1!3e${modeCode}` : '';
+}
+/** Build a place page URL (`/maps/place/...`). */
+export function buildPlaceUrl(options) {
+    const namePart = options.name ? encodePathSegment(options.name) : '';
+    const viewport = viewportSegment(options.lat, options.lng, options.zoom);
+    const data = placeDataBlob({
+        hexId: options.hexId,
+        placeId: options.placeId,
+        lat: options.lat,
+        lng: options.lng,
+        featureId: options.featureId,
+    });
+    return `${BASE}/place/${namePart}/${viewport}/data=${data}`;
+}
+/** Build a search results URL (`/maps/search/...`). */
+export function buildSearchUrl(options) {
+    const query = encodePathSegment(options.query);
+    if (options.lat != null && options.lng != null) {
+        const viewport = viewportSegment(options.lat, options.lng, options.zoom);
+        return `${BASE}/search/${query}/${viewport}`;
+    }
+    return `${BASE}/search/${query}`;
+}
+/** Build a directions URL (`/maps/dir/...`). */
+export function buildDirectionsUrl(options) {
+    const origin = encodePathSegment(options.origin);
+    const destination = encodePathSegment(options.destination);
+    const middle = options.waypoints && options.waypoints.length > 0
+        ? `${options.waypoints.map(encodePathSegment).join('/')}/`
+        : '';
+    const viewport = options.lat != null && options.lng != null
+        ? `/${viewportSegment(options.lat, options.lng, options.zoom)}`
+        : '';
+    const data = directionsDataBlob(options.mode);
+    const dataSuffix = data ? `/data=${data}` : '';
+    return `${BASE}/dir/${origin}/${middle}${destination}${viewport}${dataSuffix}`;
+}
+/** Build a bare viewport URL (`/maps/@lat,lng,zoom`). */
+export function buildViewportUrl(options) {
+    const viewport = viewportSegment(options.lat, options.lng, options.zoom);
+    const params = new URLSearchParams();
+    if (options.mapAction === 'pano') {
+        params.set('map_action', 'pano');
+    }
+    switch (options.layer) {
+        case 'transit':
+            params.set('layer', 'transit');
+            break;
+        case 'traffic':
+            params.set('layer', 'traffic');
+            break;
+        case 'bicycling':
+            params.set('layer', 'bicycling');
+            break;
+        case 'none':
+        case undefined:
+            break;
+        default: {
+            const exhaustive = options.layer;
+            throw new Error(`Unhandled map layer: ${String(exhaustive)}`);
+        }
+    }
+    const qs = params.toString();
+    return qs ? `${BASE}/${viewport}?${qs}` : `${BASE}/${viewport}`;
+}
+/**
+ * Build a Street View share URL.
+ *
+ * Uses the `@?api=1&map_action=pano` form documented by Google. Not parsed by
+ * {@link parseMapsUrl} today — verify via live HTTP instead of round-trip.
+ */
+export function buildStreetViewUrl(options) {
+    const params = new URLSearchParams();
+    params.set('api', '1');
+    params.set('map_action', 'pano');
+    params.set('viewpoint', `${formatCoord(options.lat)},${formatCoord(options.lng)}`);
+    if (options.panoId) {
+        params.set('pano', options.panoId);
+    }
+    if (options.heading != null) {
+        params.set('heading', String(options.heading));
+    }
+    if (options.pitch != null) {
+        params.set('pitch', String(options.pitch));
+    }
+    if (options.fov != null) {
+        params.set('fov', String(options.fov));
+    }
+    return `${BASE}/@?${params.toString()}`;
+}
+function buildKeylessEmbedPb(options) {
+    const hl = options.hl ?? 'en';
+    const gl = options.gl ?? 'us';
+    const ts = Date.now();
+    switch (options.kind) {
+        case 'place': {
+            if (!options.hexId)
+                return null;
+            const lat = options.lat ?? 0;
+            const lng = options.lng ?? 0;
+            const alt = viewportAltitude(lat, options.zoom ?? 15);
+            const namePart = options.name
+                ? `!2s${options.name.replace(/ /g, '+')}`
+                : '';
+            return (`!1m18!1m12!1m3!1d${alt}!2d${formatCoord(lng)}!3d${formatCoord(lat)}` +
+                `!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1` +
+                `!3m3!1m2!1s${options.hexId}${namePart}!5e0` +
+                `!3m2!1s${hl}!2s${gl}!4v${ts}!5m2!1s${hl}!2s${gl}`);
+        }
+        case 'search': {
+            if (!options.query)
+                return null;
+            const lat = options.lat ?? 0;
+            const lng = options.lng ?? 0;
+            const alt = viewportAltitude(lat, options.zoom ?? 15);
+            const q = encodeURIComponent(options.query);
+            return (`!1m18!1m12!1m3!1d${alt}!2d${formatCoord(lng)}!3d${formatCoord(lat)}` +
+                `!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1` +
+                `!3m3!1m2!1s0x0:0x0!2z${q}!5e0` +
+                `!3m2!1s${hl}!2s${gl}!4v${ts}!5m2!1s${hl}!2s${gl}`);
+        }
+        case 'directions': {
+            if (!options.origin || !options.destination)
+                return null;
+            const modeCode = options.mode ? TRAVEL_MODE_CODE[options.mode] : 0;
+            const origin = encodeURIComponent(options.origin);
+            const dest = encodeURIComponent(options.destination);
+            const wpCoords = (options.waypoints ?? [])
+                .map((wp) => `!4m3!3m2!1d0!2d0!3d0!4m1!3s${encodeURIComponent(wp)}`)
+                .join('');
+            const wpCount = options.waypoints?.length ?? 0;
+            const outerM = 12 + wpCount * 4 + 11;
+            const innerM = wpCount * 4 + 1;
+            return (`!1m${outerM}!1m12!1m3!1d1!2d0!3d0` +
+                `!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1` +
+                `!4m${innerM}!3e${modeCode}` +
+                `!4m5!1s0x0:0x0!2s${origin}!3m2!1d0!2d0` +
+                `!4m5!1s0x0:0x0!2s${dest}!3m2!1d0!2d0` +
+                wpCoords +
+                `!5e0!3m2!1s${hl}!2s${gl}!4v${ts}!5m2!1s${hl}!2s${gl}`);
+        }
+        case 'view': {
+            const lat = options.lat ?? 0;
+            const lng = options.lng ?? 0;
+            const alt = viewportAltitude(lat, options.zoom ?? 15);
+            return (`!1m14!1m12!1m3!1d${alt}!2d${formatCoord(lng)}!3d${formatCoord(lat)}` +
+                `!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!5e0` +
+                `!3m2!1s${hl}!2s${gl}!4v${ts}!5m2!1s${hl}!2s${gl}`);
+        }
+        default: {
+            const exhaustive = options.kind;
+            throw new Error(`Unhandled embed kind: ${String(exhaustive)}`);
+        }
+    }
+}
+function buildEmbedV1Url(options) {
+    const key = options.apiKey;
+    const params = new URLSearchParams({ key });
+    switch (options.kind) {
+        case 'place': {
+            const q = options.hexId ??
+                options.name ??
+                (options.lat != null && options.lng != null
+                    ? `${options.lat},${options.lng}`
+                    : '');
+            params.set('q', q);
+            if (options.zoom != null)
+                params.set('zoom', String(options.zoom));
+            return `${BASE}/embed/v1/place?${params.toString()}`;
+        }
+        case 'search': {
+            params.set('q', options.query ?? '');
+            return `${BASE}/embed/v1/search?${params.toString()}`;
+        }
+        case 'directions': {
+            params.set('origin', options.origin ?? '');
+            params.set('destination', options.destination ?? '');
+            if (options.mode)
+                params.set('mode', options.mode);
+            if (options.waypoints?.length) {
+                params.set('waypoints', options.waypoints.join('|'));
+            }
+            return `${BASE}/embed/v1/directions?${params.toString()}`;
+        }
+        case 'view': {
+            params.set('center', `${options.lat ?? 0},${options.lng ?? 0}`);
+            params.set('zoom', String(options.zoom ?? 15));
+            return `${BASE}/embed/v1/view?${params.toString()}`;
+        }
+        default: {
+            const exhaustive = options.kind;
+            throw new Error(`Unhandled embed kind: ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Build an embed iframe URL.
+ *
+ * Prefers the keyless `/maps/embed?pb=` form when a pb can be derived; falls back
+ * to `/maps/embed/v1/*` when `apiKey` is supplied or pb construction is impossible.
+ */
+export function buildEmbedUrl(options) {
+    if (options.apiKey) {
+        return { url: buildEmbedV1Url(options), keyRequired: true };
+    }
+    const pb = buildKeylessEmbedPb(options);
+    if (pb) {
+        return {
+            url: `${BASE}/embed?pb=${encodeURIComponent(pb)}`,
+            keyRequired: false,
+        };
+    }
+    return {
+        url: buildEmbedV1Url({ ...options, apiKey: 'YOUR_API_KEY' }),
+        keyRequired: true,
+    };
+}
+/** Travel mode code used in directions data blobs (!3eN). */
+export function travelModeToCode(mode) {
+    return TRAVEL_MODE_CODE[mode];
+}
+/** Travel mode from directions data blob code. */
+export function travelModeFromCode(code) {
+    const modes = ['driving', 'bicycling', 'walking', 'transit'];
+    return modes[code];
+}
+//# sourceMappingURL=maps-url-builders.js.map

package/dist/rpc/maps-url-builders.js.map

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

package/dist/rpc/nxa.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Google Nxa rpcid encoder used by Maps batchexecute.
+ *
+ * Reverse-engineered from Maps JS:
+ *   Nxa.toString(fieldNumber + 2147483648)
+ */
+/** Encode a protobuf field number to a batchexecute rpcid string. */
+export declare function encodeRpcId(fieldNumber: number): string;
+/** Decode a batchexecute rpcid back to its protobuf field number. */
+export declare function decodeRpcId(rpcid: string): number;
+/** True when string matches Maps Nxa rpcid shape (6-char alphanumeric). */
+export declare function isNxaRpcId(value: string): boolean;
+//# sourceMappingURL=nxa.d.ts.map

package/dist/rpc/nxa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nxa.d.ts","sourceRoot":"","sources":["../../src/rpc/nxa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBjD;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/rpc/nxa.js

@@ -0,0 +1,44 @@
+/**
+ * Google Nxa rpcid encoder used by Maps batchexecute.
+ *
+ * Reverse-engineered from Maps JS:
+ *   Nxa.toString(fieldNumber + 2147483648)
+ */
+const ALPHA = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const ALNUM = `${ALPHA}0123456789`;
+const NXA_OFFSET = 2_147_483_648;
+/** Encode a protobuf field number to a batchexecute rpcid string. */
+export function encodeRpcId(fieldNumber) {
+    let value = fieldNumber + NXA_OFFSET;
+    const chars = [ALPHA[value % 52]];
+    value = Math.floor(value / 52);
+    while (value > 0) {
+        chars.push(ALNUM[value % 62]);
+        value = Math.floor(value / 62);
+    }
+    return chars.join('');
+}
+/** Decode a batchexecute rpcid back to its protobuf field number. */
+export function decodeRpcId(rpcid) {
+    if (!rpcid) {
+        throw new Error('rpcid is required');
+    }
+    let suffix = 0;
+    for (let i = rpcid.length - 1; i > 0; i--) {
+        const index = ALNUM.indexOf(rpcid[i]);
+        if (index < 0) {
+            throw new Error(`Invalid rpcid character: ${rpcid[i]}`);
+        }
+        suffix = index + 62 * suffix;
+    }
+    const prefix = ALPHA.indexOf(rpcid[0]);
+    if (prefix < 0) {
+        throw new Error(`Invalid rpcid prefix: ${rpcid}`);
+    }
+    return prefix + 52 * suffix - NXA_OFFSET;
+}
+/** True when string matches Maps Nxa rpcid shape (6-char alphanumeric). */
+export function isNxaRpcId(value) {
+    return /^[a-zA-Z][a-zA-Z0-9]{5}$/.test(value);
+}
+//# sourceMappingURL=nxa.js.map

package/dist/rpc/nxa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nxa.js","sourceRoot":"","sources":["../../src/rpc/nxa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,KAAK,GAAG,sDAAsD,CAAC;AACrE,MAAM,KAAK,GAAG,GAAG,KAAK,YAAY,CAAC;AACnC,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,IAAI,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;IACrC,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAE,CAAC,CAAC;IAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAE,CAAC,CAAC;QAC/B,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,GAAG,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,GAAG,EAAE,GAAG,MAAM,GAAG,UAAU,CAAC;AAC3C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/rpc/panorama-pb.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Protobuf URL builders for Google Maps Street View / panorama endpoints.
+ *
+ * Verified against live probes — all four photometa pb blocks are required;
+ * omitting any block returns HTTP 400.
+ */
+/** Pb for `/maps/rpc/photo/listentityphotos` — panoramas near a point. */
+export declare function buildListEntityPhotosPb(params: {
+    lat: number;
+    lng: number;
+    radiusMeters: number;
+}): string;
+/** Pb for `/maps/photometa/v1` — full metadata for a panorama id. */
+export declare function buildPhotometaPb(params: {
+    panoId: string;
+    hl?: string;
+    gl?: string;
+}): string;
+/** Pb for `/maps/photometa/ac/v1` — coverage tile at Web Mercator z17. */
+export declare function buildCoverageTilePb(params: {
+    tileX: number;
+    tileY: number;
+}): string;
+/** Full URL for nearby panorama search. */
+export declare function buildListEntityPhotosUrl(params: {
+    lat: number;
+    lng: number;
+    radiusMeters: number;
+    hl: string;
+    gl: string;
+}): string;
+/** Full URL for panorama metadata. */
+export declare function buildPhotometaUrl(params: {
+    panoId: string;
+    hl: string;
+    gl: string;
+}): string;
+/** Full URL for z17 coverage tile lookup. */
+export declare function buildCoverageTileUrl(params: {
+    tileX: number;
+    tileY: number;
+    hl: string;
+    gl: string;
+}): string;
+/** Street View thumbnail URL — returns JPEG bytes without auth. */
+export declare function buildThumbnailUrl(params: {
+    panoId: string;
+    width?: number;
+    height?: number;
+    pitch?: number;
+    yaw?: number;
+}): string;
+/** Street View tile URL — zoom 0..5, x/y are tile indices at that zoom. */
+export declare function buildTileUrl(params: {
+    panoId: string;
+    x?: number;
+    y?: number;
+    zoom?: number;
+}): string;
+//# sourceMappingURL=panorama-pb.d.ts.map

package/dist/rpc/panorama-pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panorama-pb.d.ts","sourceRoot":"","sources":["../../src/rpc/panorama-pb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAKT;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAKT;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAET;AAED,2CAA2C;AAC3C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAOT;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAOT;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAOT;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAUT;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAQT"}

package/dist/rpc/panorama-pb.js

@@ -0,0 +1,71 @@
+/**
+ * Protobuf URL builders for Google Maps Street View / panorama endpoints.
+ *
+ * Verified against live probes — all four photometa pb blocks are required;
+ * omitting any block returns HTTP 400.
+ */
+const PHOTOMETA_SUFFIX_457 = '!4m57!1e1!1e2!1e3!1e4!1e5!1e6!1e8!1e12!2m1!1e1!4m1!1i48!5m1!1e1!5m1!1e2!6m1!1e1!6m1!1e2';
+const PHOTOMETA_SUFFIX_936 = '!9m36!1m3!1e2!2b1!3e2!1m3!1e2!2b0!3e3!1m3!1e3!2b1!3e2!1m3!1e3!2b0!3e3!1m3!1e8!2b0!3e3!1m3!1e1!2b0!3e3!1m3!1e4!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e10!2b0!3e3';
+const LIST_ENTITY_PHOTOS_SUFFIX = '!1e3!5m46!2m2!1i203!2i100!3m2!2i40!5b1!7m33!1m3!1e1!2b0!3e3!1m3!1e2!2b1!3e2!1m3!1e2!2b0!3e3!1m3!1e8!2b0!3e3!1m3!1e10!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e10!2b0!3e4!1m3!1e9!2b1!3e2!2b1!8m2!1m1!1e2!9b0!11m1!4b1';
+const IMAGERY_BASE = 'https://streetviewpixels-pa.googleapis.com/v1';
+const IMAGERY_CLIENT = 'maps_sv.tactile';
+/** Build locale segment embedded in photometa ctx (`!2m2!1s{hl}!2s{gl}`). */
+function buildPhotometaLocale(hl, gl) {
+    return `!1m4!1smaps_sv.tactile!11m2!2m1!1b1!2m2!1s${hl}!2s${gl}`;
+}
+/** Pb for `/maps/rpc/photo/listentityphotos` — panoramas near a point. */
+export function buildListEntityPhotosPb(params) {
+    return (LIST_ENTITY_PHOTOS_SUFFIX +
+        `!9m2!2d${params.lng}!3d${params.lat}!10d${params.radiusMeters}`);
+}
+/** Pb for `/maps/photometa/v1` — full metadata for a panorama id. */
+export function buildPhotometaPb(params) {
+    const hl = params.hl ?? 'en';
+    const gl = params.gl ?? 'us';
+    const ctx = buildPhotometaLocale(hl, gl);
+    return `${ctx}!3m3!1m2!1e2!2s${params.panoId}${PHOTOMETA_SUFFIX_457}${PHOTOMETA_SUFFIX_936}`;
+}
+/** Pb for `/maps/photometa/ac/v1` — coverage tile at Web Mercator z17. */
+export function buildCoverageTilePb(params) {
+    return `!1m1!1smaps_sv.tactile!6m3!1i${params.tileX}!2i${params.tileY}!3i17!8b1`;
+}
+/** Full URL for nearby panorama search. */
+export function buildListEntityPhotosUrl(params) {
+    const pb = buildListEntityPhotosPb(params);
+    return (`https://www.google.com/maps/rpc/photo/listentityphotos` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+/** Full URL for panorama metadata. */
+export function buildPhotometaUrl(params) {
+    const pb = buildPhotometaPb({ panoId: params.panoId, hl: params.hl, gl: params.gl });
+    return (`https://www.google.com/maps/photometa/v1` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+/** Full URL for z17 coverage tile lookup. */
+export function buildCoverageTileUrl(params) {
+    const pb = buildCoverageTilePb(params);
+    return (`https://www.google.com/maps/photometa/ac/v1` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+/** Street View thumbnail URL — returns JPEG bytes without auth. */
+export function buildThumbnailUrl(params) {
+    const w = params.width ?? 640;
+    const h = params.height ?? 480;
+    const pitch = params.pitch ?? 0;
+    const yaw = params.yaw ?? 0;
+    return (`${IMAGERY_BASE}/thumbnail` +
+        `?w=${w}&h=${h}&pitch=${pitch}&panoid=${params.panoId}&yaw=${yaw}` +
+        `&cb_client=${IMAGERY_CLIENT}`);
+}
+/** Street View tile URL — zoom 0..5, x/y are tile indices at that zoom. */
+export function buildTileUrl(params) {
+    const x = params.x ?? 0;
+    const y = params.y ?? 0;
+    const zoom = params.zoom ?? 0;
+    return (`${IMAGERY_BASE}/tile` +
+        `?cb_client=${IMAGERY_CLIENT}&panoid=${params.panoId}&x=${x}&y=${y}&zoom=${zoom}`);
+}
+//# sourceMappingURL=panorama-pb.js.map

package/dist/rpc/panorama-pb.js.map

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

package/dist/rpc/passiveassist-pb.d.ts

@@ -0,0 +1,21 @@
+export interface PassiveAssistPbParams {
+    lat: number;
+    lng: number;
+    zoom?: number;
+    psi: string;
+    width?: number;
+    height?: number;
+    chipLimit?: number;
+}
+/**
+ * Browser-captured pb shape (2026-07-31 headless live-flows + probe-target-surfaces).
+ *
+ * Uses the shorter `!1m10!2m9` camera block — the legacy `!1m16!2m15` builder
+ * with `!6m2!1f0!2f0` returns the cache-metadata stub for the same psi.
+ */
+export declare function buildPassiveAssistPb(params: PassiveAssistPbParams): string;
+export declare function buildPassiveAssistUrl(params: PassiveAssistPbParams & {
+    hl: string;
+    gl: string;
+}): string;
+//# sourceMappingURL=passiveassist-pb.d.ts.map

package/dist/rpc/passiveassist-pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passiveassist-pb.d.ts","sourceRoot":"","sources":["../../src/rpc/passiveassist-pb.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAY1E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGxG"}

package/dist/rpc/passiveassist-pb.js

@@ -0,0 +1,24 @@
+import { altitudeFromZoom } from '../utils/geo.js';
+import { PREVIEW } from './rpc-methods.js';
+/**
+ * Browser-captured pb shape (2026-07-31 headless live-flows + probe-target-surfaces).
+ *
+ * Uses the shorter `!1m10!2m9` camera block — the legacy `!1m16!2m15` builder
+ * with `!6m2!1f0!2f0` returns the cache-metadata stub for the same psi.
+ */
+export function buildPassiveAssistPb(params) {
+    const zoom = params.zoom ?? 14;
+    const alt = altitudeFromZoom(zoom, params.lat);
+    const w = params.width ?? 1440;
+    const h = params.height ?? 900;
+    const limit = params.chipLimit ?? 50;
+    return (`!1m10!2m9!1m3!1d${alt}!2d${params.lng}!3d${params.lat}` +
+        `!2m0!3m2!1i${w}!2i${h}!4f13.1` +
+        `!3m3!1s${params.psi}!7e81!15i312935!7m1!58b1` +
+        `!35m6!1i${limit}!3m3!3b1!26b1!29b1!44e11`);
+}
+export function buildPassiveAssistUrl(params) {
+    const pb = buildPassiveAssistPb(params);
+    return `https://www.google.com${PREVIEW.PASSIVE_ASSIST}?authuser=0&hl=${params.hl}&gl=${params.gl}&pb=${encodeURIComponent(pb)}`;
+}
+//# sourceMappingURL=passiveassist-pb.js.map

package/dist/rpc/passiveassist-pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passiveassist-pb.js","sourceRoot":"","sources":["../../src/rpc/passiveassist-pb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAY3C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA6B;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACrC,OAAO,CACL,mBAAmB,GAAG,MAAM,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE;QACxD,cAAc,CAAC,MAAM,CAAC,SAAS;QAC/B,UAAU,MAAM,CAAC,GAAG,0BAA0B;QAC9C,WAAW,KAAK,0BAA0B,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA0D;IAC9F,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,yBAAyB,OAAO,CAAC,cAAc,kBAAkB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,EAAE,OAAO,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AACnI,CAAC"}