googlemaps-kit 0.4.0 → 0.5.0

package/dist/known-surfaces.d.ts

@@ -1,5 +1,5 @@
 /**
- * Status of reverse-engineered Google Maps HTTP surfaces.
+ * Status of undocumented Google Maps HTTP surfaces.
  */
 export type SurfaceStatus = 'working' | 'fallback' | 'auth-required' | 'blocked' | 'unverified' | 'not-used-by-web';
 export interface SurfaceInfo {
@@ -121,7 +121,7 @@ export declare const KNOWN_SURFACES: {
         readonly status: "working";
         readonly method: "GET";
         readonly path: "/maps/vt/proto";
-        readonly notes: "256px roadmap tiles wrapped in protobuf. Satellite and 512px variants return HTTP 400.";
+        readonly notes: "256px roadmap tiles wrapped in protobuf. Named overlay layers decoded from the JS `_.er` descriptors: shading (type 5) and contours (type 6) answer real raster anonymously; traffic, transit, bike, svv, air-quality, area-busyness, crisis2, indoor, hotel-categorical-search, lore-p13n, lore-rec and travel-map-reachability only render inside the full client style context (empty placeholder tiles when probed directly).";
     };
     readonly mapTilesStream: {
         readonly status: "working";
@@ -273,6 +273,138 @@ export declare const KNOWN_SURFACES: {
         readonly path: "/maps/_/MapsWizUi/data/batchexecute";
         readonly notes: "2026 service-path format: f.req with /MapsService.Method and no at field. Works anonymously.";
     };
+    readonly mapLayerTiles: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "mt.google.com/vt?lyrs={m|p|s|y|transit|h,traffic}";
+        readonly notes: "Raster basemap and overlay tiles. `p` (terrain) and `s`/`y` (imagery) answer JPEG, the rest PNG. Traffic only paints when composited onto a base layer (`h,traffic`); a bare `traffic` key returns a transparent tile.";
+    };
+    readonly satelliteImagery: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "mt.google.com/vt?lyrs=s|y";
+        readonly notes: "Satellite (`s`) and hybrid (`y`) imagery, JPEG. earth.google.com exposes no public imagery API — mw.google.com/mw-earth does not resolve.";
+    };
+    readonly evCharging: {
+        readonly status: "fallback";
+        readonly method: "GET";
+        readonly path: "/search?tbm=map + /maps/preview/place";
+        readonly notes: "No EV RPC exists. Stations are found by categorical place search; connector type, power, and plug count come from placeData[140][1][0][2]. Live availability and pricing are not published anywhere.";
+    };
+    readonly parkingSearch: {
+        readonly status: "fallback";
+        readonly method: "GET";
+        readonly path: "/search?tbm=map";
+        readonly notes: "No parking RPC exists. Parking lots are ordinary places found by categorical search. Space counts and posted rates are not carried in place data.";
+    };
+    readonly adminRegions: {
+        readonly status: "fallback";
+        readonly method: "GET";
+        readonly path: "/search?tbm=map (reverse geocode)";
+        readonly notes: "Region hierarchy is read from the reverse-geocode address tail. No polygons are published, so AdminRegion.bounds is absent.";
+    };
+    readonly placeAttributes: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/preview/place (placeData[100][1])";
+        readonly notes: "Amenity / accessibility / payment attributes are per place. Maps publishes no global attribute catalog.";
+    };
+    readonly trafficIncidents: {
+        readonly status: "working";
+        readonly method: "POST";
+        readonly path: "/MapsTrafficService.GetAreaTraffic (root[2])";
+        readonly notes: "Incidents ride along with the area summary in the EvxQ3b response — there is no separate incident service. Each carries a headline, road name, delay in seconds and the affected stretch as cumulative 1e7 deltas. Severity is derived from the delay, not reported.";
+    };
+    readonly schoolsLayer: {
+        readonly status: "fallback";
+        readonly method: "GET";
+        readonly path: "/search?tbm=map";
+        readonly notes: "The rendered layer is vector-tile only and has no marker service, so schools come from the categorical searches the UI uses, clipped to the requested bounds.";
+    };
+    readonly buildings3d: {
+        readonly status: "fallback";
+        readonly method: "GET";
+        readonly path: "kh.google.com/rt/earth (see buildings3dRocktree)";
+        readonly notes: "No building layer exists — /maps/vt answers raster everywhere and the mapcore WASM renders one fused surface of ground, structures and canopy. map3d.getBuildings segments structures out of that mesh (4 m grid, local ground from a neighbourhood minimum, flood fill split on a 6 m roof step), so footprints are derived massing rather than surveyed outlines.";
+    };
+    readonly transitRouting: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/preview/directions (mode=transit + session block)";
+        readonly notes: "Gated on the page session block !15m3!1s{ei}!7e81!15i10142 — without it Google answers with travel-time chips and no routes. With it: full itineraries, legs, lines and colours, boarding/alighting and intermediate stops, fares, agencies, frequency and service alerts. Verified in London, New York and Tokyo.";
+    };
+    readonly terrainHillshade: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/vt/proto (!1e5!2sshading)";
+        readonly notes: "Raster hillshade tiles decoded from the JS vt layer descriptors. Global coverage from z8 up; Yosemite tiles run ~45 KB at z10 vs the 220-byte blank placeholder for dataless cells.";
+    };
+    readonly contourLines: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/vt/proto (!1e6!2scontours)";
+        readonly notes: "Elevation contour-line tiles, same descriptor family as hillshade. Publishes in the z13–15 band; outside it Google answers a valid-but-blank placeholder PNG which getOverlay surfaces as GMapsEmptyPayloadError.";
+    };
+    readonly userPrefs: {
+        readonly status: "auth-required";
+        readonly method: "POST";
+        readonly path: "/maps/_/MapsWizUi/data/batchexecute (/MapsUserPrefsService.GetUserPrefs)";
+        readonly notes: "Per-account settings store (units, home/work, region) registered as JGUSi in the web client. Anonymous calls return a bare [1] stub for every arg shape ([3] with a session context); response layout beyond int32 field 1 is inferred from JS message classes.";
+    };
+    readonly streetViewTileGrid: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "streetviewpixels-pa.googleapis.com/v1/tile (pyramid manifest)";
+        readonly notes: "Street View ships no video endpoint — the web client renders equirectangular panoramas by fetching tile pyramids described by photometa tileSizes/maxTileDimensions/tileFaceSize. panorama.getTileGrid() returns the full per-zoom URL matrix.";
+    };
+    readonly viewportMetadata: {
+        readonly status: "working";
+        readonly method: "POST";
+        readonly path: "/maps/_/MapsWizUi/data/batchexecute (/MapsViewportService.GetViewportMetadata)";
+        readonly notes: "Capability ids for a viewport. Earlier probes failed because the camera carried no altitude: the server derives zoom from it and answers [3] for any camera it cannot place. With a real altitude it returns ids such as 2, 3, 5, 6, 7, 9 and 10 — Google publishes no names for them, and open water returns nothing at all.";
+    };
+    readonly panoramaDepth: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/photometa/v1 (section !1e18)";
+        readonly notes: "A 512×256 lossless WebP per panorama, laid out equirectangularly. Pixels hold small integers indexing coplanar surfaces, not metres, and the plane equations are absent from every photometa section probed — useful as a depth segmentation. The bytes ride inside the JSON as one byte per code unit, so the response must be read as latin1.";
+    };
+    readonly panoramaElevation: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/photometa/v1 (photometa node[5][0][1][1])";
+        readonly notes: "Every panorama reports its height above sea level and above the WGS84 ellipsoid, the pair differing by the local geoid offset. Verified against Denver (1598 m), Times Square (16.8 m) and Amsterdam (4.3 m) — a far more direct elevation source than the bicycling-route fallback.";
+    };
+    readonly buildings3dRocktree: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "kh.google.com/rt/earth (PlanetoidMetadata / BulkMetadata / NodeData)";
+        readonly notes: "Google Earth rocktree octree — the anonymous source of the photorealistic mesh behind Maps 3D. Delta-packed vertex cubes, triangle strips and 512×512 JPEG textures decode losslessly; `!3u{imageryEpoch}` must only be appended when node flags carry bit 16, otherwise NodeData answers 404. map3d.getMesh/getTerrain/getBuildings wrap it.";
+    };
+    readonly searchGrid: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/search?tbm=map (per-cell via search.gridSearch)";
+        readonly notes: "Area-coverage orchestration over the ordinary search RPC: the bounding box is subdivided into Web Mercator cells at cellZoom and each cell runs one paginated search, deduped by hexId. Beats single-query pagination caps in dense cities — the same grid strategy commercial scrapers charge for.";
+    };
+    readonly rocktreePlanets: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "kh.google.com/rt/{mars|moon} (PlanetoidMetadata)";
+        readonly notes: "The rocktree octree protocol serves more planets than earth. mars and moon answer live with distinct root epochs and reference radii (3 389.5 km / 1 737.4 km); unknown names get HTTP 400 INVALID_ARGUMENT. Pass options.planet to map3d.getMesh/getTerrain/getBuildings.";
+    };
+    readonly bikeShareAvailability: {
+        readonly status: "working";
+        readonly method: "GET";
+        readonly path: "/maps/preview/place placeData[133][0] = [label, \"n/m\", null, longLabel]";
+        readonly notes: "Live dock availability from the operator feed embedded in station previews. Verified across live/detail/rich modes and operators (Citi Bike NYC \"48/57 bikes available\", Santander Cycles London, singular \"1/13 bike available\" at low counts). Absent for non-station places; parsed by extractBikeAvailability / travel().bikeShare.";
+    };
+    readonly airQualityRpc: {
+        readonly status: "auth-required";
+        readonly method: "POST";
+        readonly path: "/maps/_/MapsWizUi/data/batchexecute (GivvBd air quality, FQvEwd heatmap)";
+        readonly notes: "Legacy rpcids, not service paths — they require an XSNRF/XSRF token from WIZ_global_data.SNlM0e, which signed-out sessions never issue. Callable with signed-in cookies via sdk().features().airQuality(); response layout unparsed until reachable anonymously.";
+    };
 };
 export type KnownSurfaceName = keyof typeof KNOWN_SURFACES;
 export declare function getSurfaceInfo(name: KnownSurfaceName): SurfaceInfo;

package/dist/known-surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"known-surfaces.d.ts","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgSqB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAI9E"}
+{"version":3,"file":"known-surfaces.d.ts","sourceRoot":"","sources":["../src/known-surfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2bqB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAI9E"}

package/dist/known-surfaces.js

@@ -1,5 +1,5 @@
 /**
- * Status of reverse-engineered Google Maps HTTP surfaces.
+ * Status of undocumented Google Maps HTTP surfaces.
  */
 export const KNOWN_SURFACES = {
     search: {
@@ -114,7 +114,7 @@ export const KNOWN_SURFACES = {
         status: 'working',
         method: 'GET',
         path: '/maps/vt/proto',
-        notes: '256px roadmap tiles wrapped in protobuf. Satellite and 512px variants return HTTP 400.',
+        notes: '256px roadmap tiles wrapped in protobuf. Named overlay layers decoded from the JS `_.er` descriptors: shading (type 5) and contours (type 6) answer real raster anonymously; traffic, transit, bike, svv, air-quality, area-busyness, crisis2, indoor, hotel-categorical-search, lore-p13n, lore-rec and travel-map-reachability only render inside the full client style context (empty placeholder tiles when probed directly).',
     },
     mapTilesStream: {
         status: 'working',
@@ -266,6 +266,138 @@ export const KNOWN_SURFACES = {
         path: '/maps/_/MapsWizUi/data/batchexecute',
         notes: '2026 service-path format: f.req with /MapsService.Method and no at field. Works anonymously.',
     },
+    mapLayerTiles: {
+        status: 'working',
+        method: 'GET',
+        path: 'mt.google.com/vt?lyrs={m|p|s|y|transit|h,traffic}',
+        notes: 'Raster basemap and overlay tiles. `p` (terrain) and `s`/`y` (imagery) answer JPEG, the rest PNG. Traffic only paints when composited onto a base layer (`h,traffic`); a bare `traffic` key returns a transparent tile.',
+    },
+    satelliteImagery: {
+        status: 'working',
+        method: 'GET',
+        path: 'mt.google.com/vt?lyrs=s|y',
+        notes: 'Satellite (`s`) and hybrid (`y`) imagery, JPEG. earth.google.com exposes no public imagery API — mw.google.com/mw-earth does not resolve.',
+    },
+    evCharging: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/search?tbm=map + /maps/preview/place',
+        notes: 'No EV RPC exists. Stations are found by categorical place search; connector type, power, and plug count come from placeData[140][1][0][2]. Live availability and pricing are not published anywhere.',
+    },
+    parkingSearch: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'No parking RPC exists. Parking lots are ordinary places found by categorical search. Space counts and posted rates are not carried in place data.',
+    },
+    adminRegions: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/search?tbm=map (reverse geocode)',
+        notes: 'Region hierarchy is read from the reverse-geocode address tail. No polygons are published, so AdminRegion.bounds is absent.',
+    },
+    placeAttributes: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place (placeData[100][1])',
+        notes: 'Amenity / accessibility / payment attributes are per place. Maps publishes no global attribute catalog.',
+    },
+    trafficIncidents: {
+        status: 'working',
+        method: 'POST',
+        path: '/MapsTrafficService.GetAreaTraffic (root[2])',
+        notes: 'Incidents ride along with the area summary in the EvxQ3b response — there is no separate incident service. Each carries a headline, road name, delay in seconds and the affected stretch as cumulative 1e7 deltas. Severity is derived from the delay, not reported.',
+    },
+    schoolsLayer: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'The rendered layer is vector-tile only and has no marker service, so schools come from the categorical searches the UI uses, clipped to the requested bounds.',
+    },
+    buildings3d: {
+        status: 'fallback',
+        method: 'GET',
+        path: 'kh.google.com/rt/earth (see buildings3dRocktree)',
+        notes: 'No building layer exists — /maps/vt answers raster everywhere and the mapcore WASM renders one fused surface of ground, structures and canopy. map3d.getBuildings segments structures out of that mesh (4 m grid, local ground from a neighbourhood minimum, flood fill split on a 6 m roof step), so footprints are derived massing rather than surveyed outlines.',
+    },
+    transitRouting: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/directions (mode=transit + session block)',
+        notes: 'Gated on the page session block !15m3!1s{ei}!7e81!15i10142 — without it Google answers with travel-time chips and no routes. With it: full itineraries, legs, lines and colours, boarding/alighting and intermediate stops, fares, agencies, frequency and service alerts. Verified in London, New York and Tokyo.',
+    },
+    terrainHillshade: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/proto (!1e5!2sshading)',
+        notes: 'Raster hillshade tiles decoded from the JS vt layer descriptors. Global coverage from z8 up; Yosemite tiles run ~45 KB at z10 vs the 220-byte blank placeholder for dataless cells.',
+    },
+    contourLines: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/proto (!1e6!2scontours)',
+        notes: 'Elevation contour-line tiles, same descriptor family as hillshade. Publishes in the z13–15 band; outside it Google answers a valid-but-blank placeholder PNG which getOverlay surfaces as GMapsEmptyPayloadError.',
+    },
+    userPrefs: {
+        status: 'auth-required',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsUserPrefsService.GetUserPrefs)',
+        notes: 'Per-account settings store (units, home/work, region) registered as JGUSi in the web client. Anonymous calls return a bare [1] stub for every arg shape ([3] with a session context); response layout beyond int32 field 1 is inferred from JS message classes.',
+    },
+    streetViewTileGrid: {
+        status: 'working',
+        method: 'GET',
+        path: 'streetviewpixels-pa.googleapis.com/v1/tile (pyramid manifest)',
+        notes: 'Street View ships no video endpoint — the web client renders equirectangular panoramas by fetching tile pyramids described by photometa tileSizes/maxTileDimensions/tileFaceSize. panorama.getTileGrid() returns the full per-zoom URL matrix.',
+    },
+    viewportMetadata: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsViewportService.GetViewportMetadata)',
+        notes: 'Capability ids for a viewport. Earlier probes failed because the camera carried no altitude: the server derives zoom from it and answers [3] for any camera it cannot place. With a real altitude it returns ids such as 2, 3, 5, 6, 7, 9 and 10 — Google publishes no names for them, and open water returns nothing at all.',
+    },
+    panoramaDepth: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/photometa/v1 (section !1e18)',
+        notes: 'A 512×256 lossless WebP per panorama, laid out equirectangularly. Pixels hold small integers indexing coplanar surfaces, not metres, and the plane equations are absent from every photometa section probed — useful as a depth segmentation. The bytes ride inside the JSON as one byte per code unit, so the response must be read as latin1.',
+    },
+    panoramaElevation: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/photometa/v1 (photometa node[5][0][1][1])',
+        notes: 'Every panorama reports its height above sea level and above the WGS84 ellipsoid, the pair differing by the local geoid offset. Verified against Denver (1598 m), Times Square (16.8 m) and Amsterdam (4.3 m) — a far more direct elevation source than the bicycling-route fallback.',
+    },
+    buildings3dRocktree: {
+        status: 'working',
+        method: 'GET',
+        path: 'kh.google.com/rt/earth (PlanetoidMetadata / BulkMetadata / NodeData)',
+        notes: 'Google Earth rocktree octree — the anonymous source of the photorealistic mesh behind Maps 3D. Delta-packed vertex cubes, triangle strips and 512×512 JPEG textures decode losslessly; `!3u{imageryEpoch}` must only be appended when node flags carry bit 16, otherwise NodeData answers 404. map3d.getMesh/getTerrain/getBuildings wrap it.',
+    },
+    searchGrid: {
+        status: 'working',
+        method: 'GET',
+        path: '/search?tbm=map (per-cell via search.gridSearch)',
+        notes: 'Area-coverage orchestration over the ordinary search RPC: the bounding box is subdivided into Web Mercator cells at cellZoom and each cell runs one paginated search, deduped by hexId. Beats single-query pagination caps in dense cities — the same grid strategy commercial scrapers charge for.',
+    },
+    rocktreePlanets: {
+        status: 'working',
+        method: 'GET',
+        path: 'kh.google.com/rt/{mars|moon} (PlanetoidMetadata)',
+        notes: 'The rocktree octree protocol serves more planets than earth. mars and moon answer live with distinct root epochs and reference radii (3 389.5 km / 1 737.4 km); unknown names get HTTP 400 INVALID_ARGUMENT. Pass options.planet to map3d.getMesh/getTerrain/getBuildings.',
+    },
+    bikeShareAvailability: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place placeData[133][0] = [label, "n/m", null, longLabel]',
+        notes: 'Live dock availability from the operator feed embedded in station previews. Verified across live/detail/rich modes and operators (Citi Bike NYC "48/57 bikes available", Santander Cycles London, singular "1/13 bike available" at low counts). Absent for non-station places; parsed by extractBikeAvailability / travel().bikeShare.',
+    },
+    airQualityRpc: {
+        status: 'auth-required',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (GivvBd air quality, FQvEwd heatmap)',
+        notes: 'Legacy rpcids, not service paths — they require an XSNRF/XSRF token from WIZ_global_data.SNlM0e, which signed-out sessions never issue. Callable with signed-in cookies via sdk().features().airQuality(); response layout unparsed until reachable anonymously.',
+    },
 };
 export function getSurfaceInfo(name) {
     return KNOWN_SURFACES[name];

package/dist/known-surfaces.js.map

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

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

@@ -1,7 +1,16 @@
 import type { CreateShortUrlResult, DecodedMapsUrl } from '../types/batch-url.js';
 /**
  * Parse DecodeUrl batchexecute response.
- * Verified: lng [0][2][1][1], lat [0][2][1][2], zoom [0][2][1][5], name [0][3][2][1].
+ *
+ * Verified slot layout from decode-url-kake.json fixture:
+ *   root[0][2][1] = [typeCode, lng, lat, null, null, zoom]
+ *   root[0][3][2][1] = name string
+ *
+ * typeCode values (observed):
+ *   2 = place page URL (has name + lat/lng/zoom)
+ *   1 = search/query URL (unconfirmed — no fixture)
+ *   3 = directions URL (unconfirmed — no fixture)
+ *   4 = viewport-only URL (unconfirmed — no fixture)
  */
 export declare function extractDecodedMapsUrl(data: unknown, options?: {
     raw?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"batch-url.d.ts","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKlF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAuBhG;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,oBAAoB,CAY5G"}
+{"version":3,"file":"batch-url.d.ts","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKlF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAmChG;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,oBAAoB,CAY5G"}

package/dist/parsers/batch-url.js

@@ -1,8 +1,17 @@
-import { safeGet } from '../utils/safe-get.js';
+import { safeGet } from '../utils/payload.js';
 import { parseBatchPayload } from '../rpc/batch-rpc.js';
 /**
  * Parse DecodeUrl batchexecute response.
- * Verified: lng [0][2][1][1], lat [0][2][1][2], zoom [0][2][1][5], name [0][3][2][1].
+ *
+ * Verified slot layout from decode-url-kake.json fixture:
+ *   root[0][2][1] = [typeCode, lng, lat, null, null, zoom]
+ *   root[0][3][2][1] = name string
+ *
+ * typeCode values (observed):
+ *   2 = place page URL (has name + lat/lng/zoom)
+ *   1 = search/query URL (unconfirmed — no fixture)
+ *   3 = directions URL (unconfirmed — no fixture)
+ *   4 = viewport-only URL (unconfirmed — no fixture)
  */
 export function extractDecodedMapsUrl(data, options) {
     const root = parseBatchPayload(data);
@@ -12,16 +21,35 @@ export function extractDecodedMapsUrl(data, options) {
     let lat;
     let lng;
     let zoom;
+    let type;
     if (Array.isArray(coords)) {
+        const typeCode = typeof coords[0] === 'number' ? coords[0] : undefined;
         lng = typeof coords[1] === 'number' ? coords[1] : undefined;
         lat = typeof coords[2] === 'number' ? coords[2] : undefined;
         zoom = typeof coords[5] === 'number' ? coords[5] : undefined;
+        // Derive URL type from the type code. Only code 2 (place) is confirmed from
+        // the fixture; others are inferred from Maps URL structure conventions.
+        switch (typeCode) {
+            case 1:
+                type = 'search';
+                break;
+            case 2:
+                type = 'place';
+                break;
+            case 3:
+                type = 'directions';
+                break;
+            case 4:
+                type = 'viewport';
+                break;
+        }
     }
     return {
         name,
         lat,
         lng,
         zoom,
+        type,
         raw: options?.raw ? root : undefined,
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"batch-url.js","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa,EAAE,OAA2B;IAC9E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAW,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAY,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAS,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7C,IAAI,GAAuB,CAAC;IAC5B,IAAI,GAAuB,CAAC;IAC5B,IAAI,IAAwB,CAAC;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,IAAI,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI;QACJ,GAAG;QACH,GAAG;QACH,IAAI;QACJ,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,2BAA2B,CAAC,IAAa,EAAE,OAA2B;IACpF,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG;QACjB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO;QACL,QAAQ;QACR,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"batch-url.js","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa,EAAE,OAA2B;IAC9E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAW,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAY,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAS,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7C,IAAI,GAAuB,CAAC;IAC5B,IAAI,GAAuB,CAAC;IAC5B,IAAI,IAAwB,CAAC;IAC7B,IAAI,IAA4B,CAAC;IAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,IAAI,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7D,4EAA4E;QAC5E,wEAAwE;QACxE,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,CAAC;gBAAE,IAAI,GAAG,QAAQ,CAAC;gBAAC,MAAM;YAC/B,KAAK,CAAC;gBAAE,IAAI,GAAG,OAAO,CAAC;gBAAC,MAAM;YAC9B,KAAK,CAAC;gBAAE,IAAI,GAAG,YAAY,CAAC;gBAAC,MAAM;YACnC,KAAK,CAAC;gBAAE,IAAI,GAAG,UAAU,CAAC;gBAAC,MAAM;QACnC,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,2BAA2B,CAAC,IAAa,EAAE,OAA2B;IACpF,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG;QACjB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO;QACL,QAAQ;QACR,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC"}

package/dist/parsers/boq-reviews.d.ts

@@ -3,6 +3,13 @@
  */
 import type { ReviewsResult } from '../types/common.js';
 import type { PbNode } from '../types/protobuf.js';
+export interface ExtractBoqReviewsOptions {
+    /**
+     * When true, attach the raw boq entry array to each `Review.raw`.
+     * Useful for debugging field discovery. Default false.
+     */
+    raw?: boolean;
+}
 /** Parse GetLocalBoqProxy JSON response into reviews. */
-export declare function extractBoqReviews(data: PbNode): ReviewsResult;
+export declare function extractBoqReviews(data: PbNode, options?: ExtractBoqReviewsOptions): ReviewsResult;
 //# sourceMappingURL=boq-reviews.d.ts.map

package/dist/parsers/boq-reviews.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boq-reviews.d.ts","sourceRoot":"","sources":["../../src/parsers/boq-reviews.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQ1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAqQnD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAoB7D"}
+{"version":3,"file":"boq-reviews.d.ts","sourceRoot":"","sources":["../../src/parsers/boq-reviews.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQ1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAOnD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AA2RD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,aAAa,CAmCjG"}

package/dist/parsers/boq-reviews.js

@@ -3,8 +3,9 @@
  */
 import { asBoqRoot } from '../types/protobuf.js';
 import { normalizePhotoUrl } from '../utils/photo-url.js';
-import { safeGet } from '../utils/safe-get.js';
+import { safeGet } from '../utils/payload.js';
 import { htmlToPlainText } from './shared.js';
+import { buildReviewDetailedRating } from './place-extended.js';
 function isGoogleUserContentUrl(value) {
     return typeof value === 'string' && value.includes('googleusercontent.com');
 }
@@ -26,15 +27,28 @@ function parseReviewerCredibility(authorInfo) {
     const photoCount = typeof authorInfo[4] === 'number' ? authorInfo[4] : undefined;
     const authorPhoto = typeof authorInfo[1] === 'string' ? authorInfo[1] : undefined;
     const localGuideLevel = parseLocalGuideLevel(authorPhoto, authorInfo[5]);
+    const authorId = typeof authorInfo[6] === 'string' && /^\d+$/.test(authorInfo[6])
+        ? authorInfo[6]
+        : typeof authorInfo[7] === 'string' && /^\d+$/.test(authorInfo[7])
+            ? authorInfo[7]
+            : undefined;
     const isLocalGuide = localGuideLevel != null ||
         (typeof authorPhoto === 'string' && /-ba\d+-/i.test(authorPhoto));
     if (reviewCount == null &&
         photoCount == null &&
         localGuideLevel == null &&
+        authorId == null &&
         !isLocalGuide) {
         return undefined;
     }
-    return { reviewCount, photoCount, localGuideLevel, isLocalGuide: isLocalGuide || undefined };
+    return {
+        reviewCount,
+        photoCount,
+        localGuideLevel,
+        isLocalGuide: isLocalGuide || undefined,
+        authorId,
+        raw: authorInfo,
+    };
 }
 function parseOwnerReply(block) {
     if (!Array.isArray(block))
@@ -44,7 +58,7 @@ function parseOwnerReply(block) {
     const text = rawText ? htmlToPlainText(rawText) : undefined;
     if (!date && !text)
         return undefined;
-    return { date, text };
+    return { date, text, raw: block };
 }
 function parseReviewPhotos(review) {
     const photosNode = review[14];
@@ -65,6 +79,9 @@ function parseReviewPhotos(review) {
             aspectRatio: typeof entry[4] === 'number' ? entry[4] : undefined,
             videoUrl: typeof entry[5] === 'string' ? entry[5] : undefined,
             uploadDate: typeof entry[6] === 'string' ? entry[6] : undefined,
+            width: typeof entry[7] === 'number' ? entry[7] : undefined,
+            height: typeof entry[8] === 'number' ? entry[8] : undefined,
+            raw: entry,
         });
     }
     return photos;
@@ -128,6 +145,7 @@ function parseReviewAttributes(review) {
             label,
             value,
             rating: rating != null && rating >= 1 && rating <= 5 ? rating : undefined,
+            raw: entry,
         });
     }
     return attributes;
@@ -145,9 +163,9 @@ function parseTranslation(review) {
     if (!language && !text && !textPreview && !originalText && isTranslated == null) {
         return undefined;
     }
-    return { language, isTranslated, text, textPreview, originalText };
+    return { language, isTranslated, text, textPreview, originalText, raw: review[44] };
 }
-function parseSingleReview(review) {
+function parseSingleReview(review, options) {
     if (!Array.isArray(review) || review.length < 6) {
         return null;
     }
@@ -163,6 +181,10 @@ function parseSingleReview(review) {
     const helpfulCount = typeof review[29] === 'number' ? review[29] : undefined;
     const permalink = typeof review[12] === 'string' ? review[12] : undefined;
     const timestampMs = Array.isArray(timeInfo) && typeof timeInfo[2] === 'string' ? timeInfo[2] : undefined;
+    // visited context label — boq entry [31] in some variants
+    const visited = typeof review[31] === 'string' ? review[31] : undefined;
+    const parsedAttributes = attributes.length > 0 ? attributes : undefined;
+    const reviewDetailedRating = buildReviewDetailedRating(parsedAttributes);
     const parsed = {
         reviewId: typeof reviewId === 'string' ? reviewId : undefined,
         rating: typeof rating === 'number' && rating >= 1 && rating <= 5 ? rating : undefined,
@@ -183,10 +205,13 @@ function parseSingleReview(review) {
         ownerReply,
         helpfulCount,
         permalink,
-        attributes: attributes.length > 0 ? attributes : undefined,
+        visited,
+        attributes: parsedAttributes,
+        reviewDetailedRating,
         photoItems: structuredPhotos.length > 0 ? structuredPhotos : undefined,
         photos: structuredPhotos.length > 0 ? structuredPhotos.map((p) => p.normalizedUrl) : undefined,
         source: 'boq',
+        raw: options?.raw ? review : undefined,
     };
     if (!parsed.author && !parsed.text) {
         return null;
@@ -232,14 +257,30 @@ function buildRatingDistribution(reviews) {
     return counted > 0 ? dist : undefined;
 }
 /** Parse GetLocalBoqProxy JSON response into reviews. */
-export function extractBoqReviews(data) {
+export function extractBoqReviews(data, options) {
     const root = asBoqRoot(data);
     const reviewsNode = root ? safeGet(root, 1, 10) : undefined;
     const reviewsArray = Array.isArray(reviewsNode?.[2]) ? reviewsNode[2] : [];
     const nextPageToken = typeof reviewsNode?.[6] === 'string' ? reviewsNode[6] : undefined;
+    // Total review count may appear at root[1][10][1] (string) or root[1][1] (number)
+    let totalReviews;
+    const totalFromNode = reviewsNode?.[1];
+    if (typeof totalFromNode === 'number' && Number.isFinite(totalFromNode)) {
+        totalReviews = totalFromNode;
+    }
+    else if (typeof totalFromNode === 'string') {
+        const parsed = parseInt(totalFromNode, 10);
+        if (Number.isFinite(parsed))
+            totalReviews = parsed;
+    }
+    if (totalReviews == null) {
+        const altTotal = root ? safeGet(root, 1, 1) : undefined;
+        if (typeof altTotal === 'number' && Number.isFinite(altTotal))
+            totalReviews = altTotal;
+    }
     const reviews = [];
     for (const entry of reviewsArray) {
-        const review = parseSingleReview(entry);
+        const review = parseSingleReview(entry, options);
         if (review) {
             reviews.push(review);
         }
@@ -248,6 +289,7 @@ export function extractBoqReviews(data) {
         reviewCount: reviews.length,
         reviews,
         nextPageToken,
+        totalReviews,
         pageRatingDistribution: buildRatingDistribution(reviews),
     };
 }