googlemaps-kit 0.4.0 → 0.6.0

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

@@ -0,0 +1,406 @@
+/**
+ * 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
+ */
+/** Fully decomposed address fields extracted from place preview node[18] and node[2]. */
+export interface StructuredAddress {
+    /** Full formatted address string (e.g. "175 Main St, Staten Island, NY 10307"). */
+    formatted?: string;
+    /** Street-level line: number + street name. */
+    street?: string;
+    /** Neighbourhood / sub-locality. */
+    neighborhood?: string;
+    /** City / locality. */
+    city?: string;
+    /** State / province / region. */
+    state?: string;
+    /** Postal / ZIP code. */
+    postalCode?: string;
+    /** ISO 3166-1 alpha-2 country code, e.g. "US". */
+    countryCode?: string;
+    /** Human-readable country name. */
+    country?: string;
+    raw?: unknown;
+}
+/**
+ * Hourly busyness entry for one hour of the day.
+ *
+ * Google stores data as relative occupancy (0–100), not headcounts.
+ * `livePercent` is present only when the place is currently open and
+ * Google has live occupancy data; it is absent on the histogram-only
+ * response or when the place is closed.
+ */
+export interface PopularTimesHour {
+    /** 0–23 (local time). */
+    hour: number;
+    /**
+     * Relative busyness 0–100 based on historical aggregate data.
+     * `undefined` when Google does not have data for this hour.
+     */
+    busynessPercent?: number;
+    /** Human-readable busyness label, e.g. "Usually not too busy" (locale-dependent). */
+    label?: string;
+    /**
+     * Wait time text when Google has queue data, e.g. "Up to 15 mins wait".
+     * `undefined` when there is no wait or no data.
+     */
+    waitText?: string;
+    /** Time label from Google's UI, e.g. "6 am", "12 pm". */
+    timeLabel?: string;
+}
+/**
+ * Popular-times data for one day of the week.
+ * `dayIndex` follows JS convention: 0 = Sunday, 1 = Monday, … 6 = Saturday.
+ */
+export interface PopularTimesDay {
+    /** 0 = Sunday, 1 = Monday, … 6 = Saturday (JS Date convention). */
+    dayIndex: number;
+    /**
+     * Raw day index as Google encodes it: 1=Monday … 7=Sunday (ISO weekday).
+     * Preserved for round-tripping; consumers should use `dayIndex`.
+     */
+    rawDayIndex: number;
+    /** Lower-cased day name, e.g. "monday". */
+    dayName?: string;
+    /** Hourly busyness histogram entries. */
+    hours: PopularTimesHour[];
+}
+/**
+ * Popular times data for a place, sourced from placeData[84].
+ *
+ * Verified against live fixture (Kake Di Hatti HSR, 2026-07-31).
+ * Only present when Google has enough visit history for a place.
+ */
+export interface PopularTimesData {
+    /** Weekly histogram — one entry per day, sorted by Google's day order. */
+    days: PopularTimesDay[];
+    /**
+     * JS day index (0=Sun … 6=Sat) of the current day at time of fetch.
+     * Derived from placeData[84][1] (which uses Google's 1=Mon…7=Sun scale).
+     */
+    currentDayIndex?: number;
+    /** True when Google has real-time live busyness data for this place right now. */
+    hasLiveData?: boolean;
+    /** True when a weekly histogram is present (vs. live-only data). */
+    hasHistogram?: boolean;
+    /**
+     * Human-readable visit duration string from placeData[117][0],
+     * e.g. "People typically spend 1-2.5 hours here".
+     */
+    visitDurationText?: string;
+    /**
+     * Lower bound of typical visit duration in minutes (parsed from visitDurationText).
+     * e.g. "1-2.5 hours" → 60.
+     */
+    typicalVisitMinMinutes?: number;
+    /**
+     * Upper bound of typical visit duration in minutes (parsed from visitDurationText).
+     * e.g. "1-2.5 hours" → 150.
+     */
+    typicalVisitMaxMinutes?: number;
+}
+/** A single menu item from the inline menu card Google serves for some restaurants. */
+export interface MenuItem {
+    /** Display name of the item. */
+    name: string;
+    /** Price string in local currency, e.g. "₹120" or "$4.50". */
+    price?: string;
+    /** Item description when provided by the business. */
+    description?: string;
+    /** Photo URL for the item when Google has one. */
+    imageUrl?: string;
+    /** Section / category the item belongs to, e.g. "Starters", "Mains". */
+    section?: string;
+    raw?: unknown;
+}
+/** A section of a structured inline menu. */
+export interface MenuSection {
+    /** Section heading, e.g. "Appetizers". Omitted when the section has no heading. */
+    title?: string;
+    items: MenuItem[];
+    raw?: unknown;
+}
+/** Structured inline menu scraped from the Google Maps place card. */
+export interface PlaceMenu {
+    /** External menu URL (may differ from the structured items). */
+    menuUrl?: string;
+    /** Inline menu sections when Google serves them. */
+    sections?: MenuSection[];
+    /** Flat list of all items across all sections. */
+    allItems?: MenuItem[];
+    raw?: unknown;
+}
+/** A single answer to a place Q&A question. */
+export interface PlaceQAAnswer {
+    /** Answer author name. */
+    author?: string;
+    /**
+     * Author avatar URL.
+     * Named `authorPhoto` to match the `Review` interface convention
+     * (formerly `authorPhotoUrl` — renamed for consistency).
+     */
+    authorPhoto?: string;
+    /** Answer author's Google Maps profile URL when present (answer[2] in wire). */
+    authorProfileUrl?: string;
+    /** Answer text. */
+    text: string;
+    /** Relative or absolute date string. */
+    date?: string;
+    /** How many users found this answer helpful. */
+    upvotes?: number;
+    /** True when the answer was posted by the business owner. */
+    isOwnerAnswer?: boolean;
+    raw?: unknown;
+}
+/** A question + its answers from the public Q&A section of a place. */
+export interface PlaceQAItem {
+    questionId?: string;
+    /** Question text. */
+    question: string;
+    /** Who asked the question. */
+    askedBy?: string;
+    /** Profile URL of the person who asked the question (item[3] in wire). */
+    askedByProfileUrl?: string;
+    /** Date the question was posted. */
+    askedDate?: string;
+    /** How many users upvoted the question. */
+    upvotes?: number;
+    answers: PlaceQAAnswer[];
+    /** Direct link to this Q&A entry. */
+    url?: string;
+    raw?: unknown;
+}
+export interface PlaceQAResult {
+    items: PlaceQAItem[];
+    totalCount?: number;
+    nextPageToken?: string;
+    raw?: unknown;
+}
+/**
+ * Keyword-frequency tag shown in the review summary section of a place card.
+ * e.g. { text: "prices", count: 6, mentions: "Mentioned in 6 reviews" }
+ */
+export interface ReviewTag {
+    /** The keyword phrase. */
+    text: string;
+    /** Number of reviews mentioning this keyword (placeData[153][0][i][3][7] = totalMentions). */
+    count?: number;
+    /**
+     * Human-readable label, e.g. "Mentioned in 6 reviews".
+     * Always derived from `count` when both are set — not an independent data point.
+     * `undefined` when `count` is unavailable.
+     */
+    mentions?: string;
+    /**
+     * Count of positive/complimentary mentions (placeData[153][0][i][3][4]).
+     * Present on the primary path when Google breaks sentiment out.
+     */
+    positiveCount?: number;
+    /**
+     * Count of critical mentions (placeData[153][0][i][3][5]).
+     * Present on the primary path alongside `positiveCount`.
+     */
+    negativeCount?: number;
+    raw?: unknown;
+}
+/** A "people also search for" recommendation from a place card. */
+export interface PeopleAlsoSearch {
+    /** Place name. */
+    title: string;
+    /** Hex feature id when present. */
+    hexId?: string;
+    rating?: number;
+    reviewCount?: number;
+    category?: string;
+    thumbnailUrl?: string;
+    raw?: unknown;
+}
+/** A business-owner-posted update visible on the place card. */
+export interface OwnerUpdate {
+    updateId?: string;
+    text?: string;
+    imageUrl?: string;
+    date?: string;
+    ctaLabel?: string;
+    ctaUrl?: string;
+    raw?: unknown;
+}
+/** A single fuel grade price at a gas station. */
+export interface GasPrice {
+    /** Fuel grade label, e.g. "Regular", "Mid", "Premium", "Diesel". */
+    grade: string;
+    /** Price string, e.g. "$3.45". */
+    price: string;
+    /** Currency code when parseable, e.g. "USD". */
+    currency?: string;
+    /** Price as a float when parseable. */
+    priceValue?: number;
+    /** Timestamp or relative date when this price was last updated. */
+    updatedAt?: string;
+    raw?: unknown;
+}
+/** A hotel booking offer shown on the place card. */
+export interface HotelBookingOffer {
+    /** Booking provider name, e.g. "Booking.com", "Hotels.com". */
+    provider: string;
+    /** Price per night string. */
+    price?: string;
+    /** Whether this is the hotel's official site. */
+    isOfficialSite?: boolean;
+    /** Booking link URL. */
+    url?: string;
+    /** Google-wrapped redirect URL. */
+    googleUrl?: string;
+    raw?: unknown;
+}
+/** A nearby hotel stub shown in the "similar hotels" section. */
+export interface NearbyHotel {
+    name: string;
+    rating?: number;
+    reviewCount?: number;
+    description?: string;
+    price?: string;
+    hexId?: string;
+    raw?: unknown;
+}
+/** Hotel-specific fields extracted from the place card. */
+export interface HotelData {
+    /** Star rating string, e.g. "4-star hotel". */
+    stars?: string;
+    /** Numeric star count parsed from the string (1–5). */
+    starCount?: number;
+    description?: string;
+    /** Check-in date from a search context (YYYY-MM-DD), if present. */
+    checkInDate?: string;
+    /** Check-out date from a search context (YYYY-MM-DD), if present. */
+    checkOutDate?: string;
+    /** Live booking offers shown on the card. */
+    bookingOffers?: HotelBookingOffer[];
+    /** Nearby / similar hotels. */
+    similarHotels?: NearbyHotel[];
+    raw?: unknown;
+}
+/** Table reservation provider shown on a restaurant card. */
+export interface TableReservationProvider {
+    name: string;
+    /** Google-wrapped reservation URL. */
+    reserveTableUrl?: string;
+    raw?: unknown;
+}
+/** Restaurant-specific fields. */
+export interface RestaurantData {
+    /** Structured reservation provider when Google shows an inline "Reserve a table" button. */
+    reservationProvider?: TableReservationProvider;
+    /** External table reservation links (provider name → URL). */
+    tableReservationLinks?: Array<{
+        name: string;
+        url: string;
+    }>;
+    /** Delivery / ordering links (provider name → URL). */
+    orderLinks?: Array<{
+        name: string;
+        url: string;
+    }>;
+    raw?: unknown;
+}
+/** All stable identifiers Google attaches to a place, gathered in one object. */
+export interface PlaceIdentifiers {
+    /** Hex feature id "0x…:0x…" — most stable cross-session id. */
+    hexId?: string;
+    /** ChIJ… base64 place id. */
+    placeId?: string;
+    /** Numeric content id (cid) used in some Maps URLs. */
+    cid?: string;
+    /** Knowledge Graph entity id (/m/… or /g/…). */
+    kgmid?: string;
+    /** Internal feature id /g/… when distinct from kgmid. */
+    featureId?: string;
+    /** ftid (full feature token id) used in place preview URLs. */
+    ftid?: string;
+}
+export type BusinessOperatingStatus = 'open' | 'closed' | 'permanently_closed' | 'temporarily_closed' | 'unknown';
+/**
+ * Extended place details with all structured fields.
+ *
+ * This extends the base `PlaceDetails` with every additional data point
+ * that can be extracted from the place preview protobuf and related endpoints.
+ *
+ * The `raw` field holds the full protobuf-over-JSON tree from the server,
+ * serialized as-is. It is `undefined` unless you pass `{ raw: true }` to
+ * the service/intent method. When present it contains **everything** Google
+ * sent — useful for field discovery and debugging.
+ */
+export interface PlaceDetailsExtended {
+    /** All Google-assigned identifiers for this place. */
+    ids?: PlaceIdentifiers;
+    /** Decomposed address fields. */
+    structuredAddress?: StructuredAddress;
+    /** Operating status derived from hours / closed flags. */
+    operatingStatus?: BusinessOperatingStatus;
+    /** True if the business listing has been claimed by an owner. */
+    isClaimed?: boolean;
+    /** Popular times histogram + live busyness + typical visit duration. */
+    popularTimes?: PopularTimesData;
+    /** Review keyword/topic frequency tags shown under the star rating. */
+    reviewTags?: ReviewTag[];
+    /** "People also search for" place recommendations. */
+    peopleAlsoSearch?: PeopleAlsoSearch[];
+    /** Owner-posted updates on the place card. */
+    ownerUpdates?: OwnerUpdate[];
+    /** Gas station fuel prices when applicable. */
+    gasPrices?: GasPrice[];
+    /** Hotel-specific card data when the place is a hotel. */
+    hotelData?: HotelData;
+    /** Restaurant-specific card data when applicable. */
+    restaurantData?: RestaurantData;
+    /** Inline menu when Google serves structured menu items. */
+    menu?: PlaceMenu;
+    /** Public Q&A section — populated separately via `places.qa()`. */
+    qa?: PlaceQAResult;
+    /**
+     * Raw protobuf-over-JSON response tree.
+     * Present only when the caller requested `raw: true`.
+     * Contains every field Google sent, typed as `unknown`.
+     */
+    raw?: unknown;
+}
+/**
+ * Extension fields for SearchResult that are present in the search response
+ * but not in the base type.
+ */
+export interface SearchResultExtended {
+    /** 1-based position in the search results list. */
+    rank?: number;
+    /** True when this result is a paid advertisement. */
+    isAd?: boolean;
+    /** Ad position (1-based) when `isAd` is true. */
+    adPosition?: number;
+    /** Numeric cid (content id). */
+    cid?: string;
+    /** kgmid (/g/… or /m/…). */
+    kgmid?: string;
+    /** Price range string (e.g. "$$" or "₹1,000–2,000"). */
+    priceRange?: string;
+    /** Decomposed address. */
+    structuredAddress?: StructuredAddress;
+    /** True when the listing has been claimed. */
+    isClaimed?: boolean;
+    isPermanentlyClosed?: boolean;
+    isTemporarilyClosed?: boolean;
+    /** Extended place details when fetched via `full` mode search. */
+    extended?: PlaceDetailsExtended;
+    raw?: unknown;
+}
+//# sourceMappingURL=place-extended.d.ts.map

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.
@@ -69,11 +80,27 @@ export interface ReviewClientFilters {
 }
 /** Place-wide star histogram from GetPlaceUgcPostAggregates (batchexecute). */
 export interface PlaceReviewRatingDistribution {
-    /** Count of 5-star reviews (index 0 in RPC array). */
     fiveStar: number;
     fourStar: number;
     threeStar: number;
     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 in wire order:
+     * `[oneStar, twoStar, threeStar, fourStar, fiveStar]` — index 0 = 1-star, index 4 = 5-star.
+     * Verified against Kake Di Hatti (4.4 from `[70,10,31,81,551]`) and Sparq on Rio.
+     */
+    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