googlemaps-kit 0.3.1 → 0.5.0

package/dist/types/place-extended.d.ts.map

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

package/dist/types/place-extended.js

@@ -0,0 +1,18 @@
+/**
+ * Extended place entity types.
+ *
+ * These supplement the core `PlaceDetails` / `SearchResult` from common.ts with:
+ *  - Structured address decomposition
+ *  - Popular times (histogram + live busyness + visit duration)
+ *  - Menu items
+ *  - Q&A section
+ *  - Review keyword tags
+ *  - Hotel-specific data
+ *  - Restaurant-specific data (table reservation provider)
+ *  - Gas prices
+ *  - "People also search for" recommendations
+ *  - Owner updates
+ *  - Raw escape hatch on every entity
+ */
+export {};
+//# sourceMappingURL=place-extended.js.map

package/dist/types/place-extended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-extended.js","sourceRoot":"","sources":["../../src/types/place-extended.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/types/protobuf.d.ts

@@ -1,6 +1,6 @@
 /**
  * Google Maps protobuf-over-JSON wire types.
- * Positional tuple indices are reverse-engineered from network traffic + parsers.
+ * Positional tuple indices are observed on live network traffic and verified by parsers/tests.
  *
  * Index reference (PlaceDataNode):
  *   [4] rating block, [7] contact, [9] geo, [10] hexId, [11] name,

package/dist/types/protobuf.js

@@ -1,6 +1,6 @@
 /**
  * Google Maps protobuf-over-JSON wire types.
- * Positional tuple indices are reverse-engineered from network traffic + parsers.
+ * Positional tuple indices are observed on live network traffic and verified by parsers/tests.
  *
  * Index reference (PlaceDataNode):
  *   [4] rating block, [7] contact, [9] geo, [10] hexId, [11] name,

package/dist/types/reviews.d.ts

@@ -7,6 +7,7 @@ export interface ReviewOwnerReply {
     date?: string;
     /** Plain-text owner reply — boq entry [4][2] (HTML stripped). */
     text?: string;
+    raw?: unknown;
 }
 /** Local Guide / contributor stats from boq entry [3]. */
 export interface ReviewerCredibility {
@@ -18,6 +19,9 @@ export interface ReviewerCredibility {
     localGuideLevel?: number;
     /** True when avatar URL contains Local Guide badge markers. */
     isLocalGuide?: boolean;
+    /** Google user id of the reviewer (numeric string) when parseable. */
+    authorId?: string;
+    raw?: unknown;
 }
 /** Structured review-attached photo (boq entry [14][*]). */
 export interface ReviewPhoto {
@@ -32,6 +36,11 @@ export interface ReviewPhoto {
     aspectRatio?: number;
     videoUrl?: string;
     uploadDate?: string;
+    /** Width in pixels when available. */
+    width?: number;
+    /** Height in pixels when available. */
+    height?: number;
+    raw?: unknown;
 }
 /** Per-aspect or chip attribute on a review (boq entry [30][*]). */
 export interface ReviewAttribute {
@@ -43,6 +52,7 @@ export interface ReviewAttribute {
     value?: string;
     /** Numeric aspect rating 1–5 when the attribute is a star aspect. */
     rating?: number;
+    raw?: unknown;
 }
 /** Translation metadata (boq entry [44]). */
 export interface ReviewTranslation {
@@ -56,6 +66,7 @@ export interface ReviewTranslation {
     textPreview?: string;
     /** Original text when both original and translation are present — boq entry [32] when non-empty. */
     originalText?: string;
+    raw?: unknown;
 }
 /**
  * Client-side filters applied after fetching boq reviews.
@@ -76,4 +87,21 @@ export interface PlaceReviewRatingDistribution {
     twoStar: number;
     oneStar: number;
 }
+/** Place UGC/review aggregates from GetPlaceUgcPostAggregates batchexecute RPC. */
+export interface PlaceUgcAggregates {
+    rating?: number;
+    /**
+     * Star count histogram as a fixed 5-element tuple:
+     * `[fiveStar, fourStar, threeStar, twoStar, oneStar]` — index 0 = 5-star, index 4 = 1-star.
+     * Verified against Kake Di Hatti + duplicates fixtures.
+     */
+    ratingDistribution?: [number, number, number, number, number];
+    totalCount?: number;
+    raw?: unknown;
+}
+export interface GetPlaceUgcAggregatesOptions {
+    hexId: string;
+    /** Override session psi (scraped from Maps bootstrap when omitted). */
+    psi?: string;
+}
 //# sourceMappingURL=reviews.d.ts.map

package/dist/types/reviews.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/types/reviews.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,6BAA6B;IAC5C,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/types/reviews.ts"],"names":[],"mappings":"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"}

package/dist/types/reviews.js.map

@@ -1 +1 @@
-{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/types/reviews.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/types/reviews.ts"],"names":[],"mappings":"AAEA;;GAEG"}

package/dist/types/route-optimization.d.ts

@@ -0,0 +1,56 @@
+import type { Coordinates, TravelMode } from './common.js';
+export interface OptimizeWaypointsOptions {
+    /**
+     * Fixed start point. Omit for an open tour that may begin at any stop.
+     */
+    origin?: Coordinates | string;
+    /**
+     * Fixed end point. Omit to end at the last visited stop.
+     * With `roundTrip`, defaults to `origin`.
+     */
+    destination?: Coordinates | string;
+    /** Stops to visit, in the caller's current (unoptimized) order. */
+    stops: Array<Coordinates | string>;
+    /** Travel mode for all legs (default `driving`). */
+    mode?: TravelMode;
+    /** Return to `origin` after the final stop (default false). */
+    roundTrip?: boolean;
+    /** Minimize total duration (default) or total distance. */
+    metric?: 'duration' | 'distance';
+    /**
+     * Also fetch turn-by-turn legs for the optimized order via
+     * `/maps/preview/directions` — one extra request per leg (default false).
+     */
+    includeLegs?: boolean;
+    /** Max parallel matrix requests (default 8). */
+    concurrency?: number;
+    hl?: string;
+    gl?: string;
+}
+export interface OptimizedLeg {
+    from: Coordinates | string;
+    to: Coordinates | string;
+    durationSeconds?: number;
+    distanceMeters?: number;
+}
+export interface OptimizeWaypointsResult {
+    /** Stop indices in visiting order — a permutation of `[0, stops.length)`. */
+    order: number[];
+    /** The reordered stop list, ready to pass back as waypoints. */
+    stops: Array<Coordinates | string>;
+    totalDurationSeconds?: number;
+    totalDistanceMeters?: number;
+    /** Cost of the caller's original order, same metric, when computable. */
+    baselineDurationSeconds?: number;
+    baselineDistanceMeters?: number;
+    /** Percentage improvement over the input order (positive = better). */
+    improvementPercent?: number;
+    /** Present when `includeLegs` is true. */
+    legs?: OptimizedLeg[];
+    /** Unique origin×destination pairs resolved in the matrix fan-out. */
+    matrixRequests: number;
+    /** Directions requests issued for legs (0 unless `includeLegs`). */
+    legRequests: number;
+    timingMs: number;
+}
+//# sourceMappingURL=route-optimization.d.ts.map

package/dist/types/route-optimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-optimization.d.ts","sourceRoot":"","sources":["../../src/types/route-optimization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;IACnC,oDAAoD;IACpD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/route-optimization.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-optimization.js.map

package/dist/types/route-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-optimization.js","sourceRoot":"","sources":["../../src/types/route-optimization.ts"],"names":[],"mappings":""}

package/dist/types/search-along-route.d.ts

@@ -0,0 +1,49 @@
+import type { Coordinates, SearchResult, TravelMode } from './common.js';
+export interface SearchAlongRouteOptions {
+    origin: Coordinates | string;
+    destination: Coordinates | string;
+    /** What to search for near the route, e.g. `"coffee"`. */
+    query: string;
+    /** Travel mode used to fetch the route geometry (default `driving`). */
+    mode?: TravelMode;
+    /**
+     * How many points to sample along the route for biased searches.
+     * Default 5, clamped to 1–10. Each sample is one search request.
+     */
+    samples?: number;
+    /** Per-sample search radius in metres (default 5_000). */
+    radiusMeters?: number;
+    /** Results per sample search (default 10). */
+    limitPerSample?: number;
+    /**
+     * Drop hits farther than this straight-line distance from the route
+     * polyline, in metres. Default: no filtering.
+     */
+    maxDetourMeters?: number;
+    /** Parallel sample searches (default 4). */
+    concurrency?: number;
+    hl?: string;
+    gl?: string;
+}
+export interface RouteSearchHit extends SearchResult {
+    /** Straight-line distance in metres from this place to the nearest point on the route polyline. */
+    detourMeters: number;
+    /** Index of the route sample whose search found this hit. */
+    sampleIndex: number;
+}
+export interface SearchAlongRouteResult {
+    places: RouteSearchHit[];
+    route: {
+        distanceMeters?: number;
+        durationSeconds?: number;
+        summary?: string;
+        /** Decoded route polyline used for sampling and detour maths. */
+        path: Coordinates[];
+        /** The sampled bias centers that were searched. */
+        samples: Coordinates[];
+    };
+    /** HTTP requests issued: 1 directions + N searches (deduped hits across samples). */
+    requestCount: number;
+    timingMs: number;
+}
+//# sourceMappingURL=search-along-route.d.ts.map

package/dist/types/search-along-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-along-route.d.ts","sourceRoot":"","sources":["../../src/types/search-along-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC;IAClC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE;QACL,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iEAAiE;QACjE,IAAI,EAAE,WAAW,EAAE,CAAC;QACpB,mDAAmD;QACnD,OAAO,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;IACF,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/search-along-route.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-along-route.js.map

package/dist/types/search-along-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-along-route.js","sourceRoot":"","sources":["../../src/types/search-along-route.ts"],"names":[],"mappings":""}

package/dist/types/search-filters.d.ts

@@ -1,5 +1,5 @@
 /**
- * Search filter types reverse-engineered from Maps client JS (FRNZOb.js / eH4Qrd.js).
+ * Search filter types matched against the Maps web client (FRNZOb.js / eH4Qrd.js).
  *
  * NOT EFFECTIVE for anonymous HTTP: live probing showed none of these encodings change
  * `search?tbm=map` results — parameters are silently ignored. Registered as `searchFilters`

package/dist/types/search-filters.js

@@ -1,5 +1,5 @@
 /**
- * Search filter types reverse-engineered from Maps client JS (FRNZOb.js / eH4Qrd.js).
+ * Search filter types matched against the Maps web client (FRNZOb.js / eH4Qrd.js).
  *
  * NOT EFFECTIVE for anonymous HTTP: live probing showed none of these encodings change
  * `search?tbm=map` results — parameters are silently ignored. Registered as `searchFilters`

package/dist/types/suggest.d.ts

@@ -2,6 +2,14 @@
 export interface SuggestOptions {
     /** Partial query text typed by the user. */
     query: string;
+    /**
+     * Bias point for suggestions — the same `{ lat, lng }` shape the other
+     * services take. Wins over the flat `lat` / `lng` fields when both are given.
+     */
+    location?: {
+        lat: number;
+        lng: number;
+    };
     /** Camera latitude — biases suggestions toward this viewport (default Bangalore). */
     lat?: number;
     /** Camera longitude — biases suggestions toward this viewport (default Bangalore). */
@@ -23,8 +31,8 @@ export interface SuggestOptions {
     /** Include the raw parsed protobuf tree in the result. */
     raw?: boolean;
 }
-export type SuggestionKind = 'query' | 'place';
-/** A single omnibox suggestion — either a query completion or a place hit. */
+export type SuggestionKind = 'query' | 'place' | 'route';
+/** A single omnibox suggestion — either a query completion, a place hit, or a route. */
 export interface Suggestion {
     kind: SuggestionKind;
     /** Best display text (full description or primary line). */
@@ -43,6 +51,21 @@ export interface Suggestion {
     thumbnailUrl?: string;
     /** ISO 3166-1 alpha-2 country code when present. */
     countryCode?: string;
+    /** Suggest response subtype / section discriminator when present. */
+    subtype?: number;
+    /** Ranking / source score when present. */
+    score?: number;
+    /**
+     * Distance string shown for nearby place suggestions, e.g. "0.3 mi" or "500 m".
+     * Present only when the suggest response includes proximity ranking.
+     */
+    distanceText?: string;
+    /**
+     * Category or type hint shown as third line in some suggest responses
+     * (e.g. "Restaurant", "Coffee shop").
+     */
+    typeHint?: string;
+    raw?: unknown;
 }
 /** Parsed omnibox autocomplete response. */
 export interface SuggestResult {

package/dist/types/suggest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/types/suggest.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/types/suggest.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzD,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/types/tiles.d.ts

@@ -62,4 +62,44 @@ export interface MapIconResult {
     width: number;
     height: number;
 }
+/** Options for fetching a specific map layer tile. */
+export interface MapLayerTileOptions {
+    z: number;
+    x: number;
+    y: number;
+    layer: 'standard' | 'satellite' | 'hybrid' | 'terrain';
+    scale?: 1 | 2;
+}
+/**
+ * Named `/maps/vt` overlay layers decoded from the Maps JS layer descriptors
+ * (`_.er` messages: field 1 = type enum, field 2 = layer name).
+ *
+ * Three answer real raster tiles anonymously:
+ * - `hillshade` (`shading`, type 5) — terrain hillshade, global from z8
+ * - `contours` (type 6) — elevation contour lines, observed band z13–15
+ * - `airQualityHeatmap` (`air-quality-heatmap`, type 2) — AQI heatmap, z5–15,
+ *   strongest over cities
+ *
+ * Every other named layer observed in the JS bundle — traffic, transit, bike,
+ * svv, air-quality, area-busyness, crisis2, hotel-categorical-search, indoor,
+ * lore-p13n, lore-rec, travel-map-reachability — renders only inside the full
+ * web client style context and returns empty placeholder tiles when probed
+ * directly.
+ */
+export type MapOverlayLayer = 'hillshade' | 'contours' | 'airQualityHeatmap';
+/** Options for fetching an overlay tile by Web Mercator indices. */
+export interface MapOverlayFetchOptions {
+    z: number;
+    x: number;
+    y: number;
+    /** Overlay layer (default `hillshade`). */
+    layer?: MapOverlayLayer;
+}
+/** Options for fetching an overlay tile by lat/lng. */
+export interface MapOverlayLatLngOptions {
+    lat: number;
+    lng: number;
+    zoom: number;
+    layer?: MapOverlayLayer;
+}
 //# sourceMappingURL=tiles.d.ts.map

package/dist/types/tiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/types/tiles.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/types/tiles.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAE7E,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/types/traffic.d.ts

@@ -1,9 +1,20 @@
 /** Area traffic report from GetAreaTraffic batchexecute RPC. */
+import type { Coordinates } from './common.js';
 export interface AreaTrafficReport {
     hasTraffic: boolean;
-    severity?: number;
+    /**
+     * Traffic congestion severity level:
+     * `0` = no traffic, `1` = light, `2` = moderate, `3` = heavy, `4` = severe.
+     * Matches Google Maps internal traffic overlay codes.
+     */
+    severity?: 0 | 1 | 2 | 3 | 4;
     summary?: string;
     detail?: string;
+    /**
+     * Traffic incident icon URLs.
+     * Reserved — returns an empty array in all currently observed responses.
+     * Kept for forward compatibility if Google starts populating this slot.
+     */
     iconUrls?: string[];
     raw?: unknown;
 }
@@ -19,4 +30,50 @@ export interface GetAreaTrafficOptions {
     /** Override session psi token (scraped automatically when omitted). */
     psi?: string;
 }
+export type IncidentType = 'accident' | 'roadClosure' | 'roadWork' | 'congestion' | 'other';
+export type IncidentSeverity = 'critical' | 'major' | 'moderate' | 'minor';
+export interface TrafficIncident {
+    /** Google's incident id. */
+    id: string;
+    type: IncidentType;
+    /**
+     * Derived from {@link TrafficIncident.delay}, not reported by Google:
+     * `critical` ≥ 20 min, `major` ≥ 10, `moderate` ≥ 5, otherwise `minor`.
+     */
+    severity: IncidentSeverity;
+    /**
+     * Latitude of the first point of {@link TrafficIncident.path}.
+     * Omitted when Google publishes no decodable path for the incident.
+     */
+    lat?: number;
+    /** Longitude of the first path point. Omitted when there is no path. */
+    lng?: number;
+    /** Headline, e.g. `"Slowdown on E 42nd St"`. */
+    title: string;
+    /** Delay blurb, e.g. `"14-min delay"`. */
+    description?: string;
+    startTime?: Date;
+    endTime?: Date;
+    /** Road names the incident sits on. */
+    affectedRoads?: string[];
+    delay?: {
+        estimatedMinutes: number;
+        seconds: number;
+        text?: string;
+    };
+    /** Affected stretch of road, decoded from the response's delta-encoded points. */
+    path?: Coordinates[];
+    /** {@link TrafficIncident.path} as an encoded polyline. */
+    polyline?: string;
+    /** Incident icon served by maps.gstatic.com. */
+    iconUrl?: string;
+    source?: string;
+}
+export interface TrafficIncidentsOptions {
+    neLat: number;
+    neLng: number;
+    swLat: number;
+    swLng: number;
+    psi?: string;
+}
 //# sourceMappingURL=traffic.d.ts.map

package/dist/types/traffic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/types/traffic.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/types/traffic.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAC5F,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,kFAAkF;IAClF,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}