googlemaps-kit 0.4.0 → 0.5.0

package/dist/services/traffic.js.map

@@ -1 +1 @@
-{"version":3,"file":"traffic.js","sourceRoot":"","sources":["../../src/services/traffic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,YAAY,EAC3B,oBAAoB,CAAC;YACnB,GAAG;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CACH,CAAC;QAEF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,wDAAwD,EAAE;YACjF,OAAO,EAAE;gBACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjD,MAAM,EAAE,WAAW;aACpB;YACD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"traffic.js","sourceRoot":"","sources":["../../src/services/traffic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,YAAY,EAC3B,oBAAoB,CAAC;YACnB,GAAG;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CACH,CAAC;QAEF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,YAAY,CAAC,OAAgC;QACjD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,YAAY,EAC3B,oBAAoB,CAAC;YACnB,GAAG;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CACH,CAAC;QAEF,OAAO,uBAAuB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,wDAAwD,EAAE;YACjF,OAAO,EAAE;gBACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjD,MAAM,EAAE,WAAW;aACpB;YACD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;IACjD,CAAC;CACF"}

package/dist/services/transit.d.ts

@@ -1,22 +1,39 @@
 import { HttpClient } from '../client/http-client.js';
 import type { GMapsConfig } from '../types/common.js';
-import type { GetStationDeparturesOptions, ListTransitLinesOptions, TransitStationBoard } from '../types/transit.js';
-import type { MapsPreviewPlaceResponse } from '../types/protobuf.js';
+import type { GetStationDeparturesOptions, ListTransitLinesOptions, TransitRouteOptions, TransitRouteResult, TransitStationBoard } from '../types/transit.js';
 export declare class TransitService {
     private http;
     private config;
     private places;
+    private directions;
+    private geocode;
     constructor(http: HttpClient, config?: GMapsConfig);
     /**
      * Live departure board for a transit station (place preview placeData[62]).
      * Requires a rich/detail preview with coordinates for full schedule rows.
      */
     getStationDepartures(options: GetStationDeparturesOptions): Promise<TransitStationBoard>;
+    /**
+     * Full transit routing from origin to destination.
+     * Returns all transit routes with transfers, stops, and line information.
+     */
+    /**
+     * Transit itineraries between two points.
+     *
+     * Backed by `/maps/preview/directions` in transit mode. The request carries
+     * the page session token, without which Google returns travel-time chips and
+     * no routes at all. Returns every itinerary Google offers, each with its legs,
+     * lines, stops, fare and service alerts.
+     *
+     * String endpoints are geocoded first.
+     */
+    getRoute(options: TransitRouteOptions): Promise<TransitRouteResult>;
+    /** Coordinates for an endpoint, geocoding a string when needed. */
+    private resolveEndpoint;
     /**
      * Probe ListTransitLines batchexecute (currently returns error [3] for anonymous callers).
      * Exposed for research scripts; prefer getStationDepartures for live schedules.
      */
     probeListTransitLines(options: ListTransitLinesOptions): Promise<unknown>;
 }
-export declare function extractTransitBoardFromPreview(data: MapsPreviewPlaceResponse): TransitStationBoard | undefined;
 //# sourceMappingURL=transit.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,wBAAwB,EAAiB,MAAM,sBAAsB,CAAC;AAGpF,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAgB;gBAElB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAMtD;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB9F;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBhF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,GAAG,mBAAmB,GAAG,SAAS,CAI9G"}
+{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAUtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EAEvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAkB7B,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAQtD;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB9F;;;OAGG;IACH;;;;;;;;;OASG;IACG,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4BzE,mEAAmE;YACrD,eAAe;IAa7B;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBhF"}

package/dist/services/transit.js

@@ -2,15 +2,35 @@ import { extractTransitStationBoard } from '../parsers/transit.js';
 import { buildListTransitLinesArgs } from '../rpc/batch-request-builders.js';
 import { BATCH_SERVICES } from '../rpc/batch-services.js';
 import { createRpcClient, isBatchErrorCode, parseBatchPayload } from '../rpc/batch-rpc.js';
+import { buildDirectionsUrls } from '../rpc/pb-builders.js';
+import { extractTransitRoutes } from '../parsers/transit.js';
+import { DirectionsService } from './directions.js';
+import { GeocodeService } from './geocode.js';
+import { GMapsError } from '../types/common.js';
 import { PlacesService } from './places.js';
+/** Map the transit preference list onto the single pb routing-preference slot. */
+function toRoutingPreference(preferences) {
+    if (!preferences?.length)
+        return undefined;
+    if (preferences.includes('fewerTransfers'))
+        return 'fewer_transfers';
+    if (preferences.includes('avoidSurface') || preferences.includes('preferRail')) {
+        return 'less_walking';
+    }
+    return undefined;
+}
 export class TransitService {
     http;
     config;
     places;
+    directions;
+    geocode;
     constructor(http, config = {}) {
         this.http = http;
         this.config = config;
         this.places = new PlacesService(http, config);
+        this.directions = new DirectionsService(http, config);
+        this.geocode = new GeocodeService(http, config);
     }
     /**
      * Live departure board for a transit station (place preview placeData[62]).
@@ -34,6 +54,54 @@ export class TransitService {
         }
         return board;
     }
+    /**
+     * Full transit routing from origin to destination.
+     * Returns all transit routes with transfers, stops, and line information.
+     */
+    /**
+     * Transit itineraries between two points.
+     *
+     * Backed by `/maps/preview/directions` in transit mode. The request carries
+     * the page session token, without which Google returns travel-time chips and
+     * no routes at all. Returns every itinerary Google offers, each with its legs,
+     * lines, stops, fare and service alerts.
+     *
+     * String endpoints are geocoded first.
+     */
+    async getRoute(options) {
+        const start = performance.now();
+        const origin = await this.resolveEndpoint(options.origin);
+        const destination = await this.resolveEndpoint(options.destination);
+        const sessionToken = await this.directions.sessionToken(origin);
+        const [url] = buildDirectionsUrls({
+            origin,
+            destination,
+            mode: 'transit',
+            hl: this.config.hl ?? 'en',
+            gl: this.config.gl ?? 'us',
+            departureTime: options.departureTime ? Math.floor(options.departureTime.getTime() / 1000) : undefined,
+            arrivalTime: options.arrivalTime ? Math.floor(options.arrivalTime.getTime() / 1000) : undefined,
+            transitModes: options.modes,
+            transitRoutingPreference: toRoutingPreference(options.preferences),
+            sessionToken,
+        });
+        const data = (await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+        }));
+        return { routes: extractTransitRoutes(data), timingMs: performance.now() - start };
+    }
+    /** Coordinates for an endpoint, geocoding a string when needed. */
+    async resolveEndpoint(value) {
+        if (typeof value !== 'string')
+            return value;
+        const response = await this.geocode.geocode(value);
+        const hit = response.result ?? response.alternatives[0];
+        if (!hit) {
+            throw new GMapsError(`Could not resolve transit endpoint: ${value}`);
+        }
+        return { lat: hit.lat, lng: hit.lng };
+    }
     /**
      * Probe ListTransitLines batchexecute (currently returns error [3] for anonymous callers).
      * Exposed for research scripts; prefer getStationDepartures for live schedules.
@@ -53,7 +121,7 @@ export class TransitService {
         return parsed;
     }
 }
-export function extractTransitBoardFromPreview(data) {
+function extractTransitBoardFromPreview(data) {
     const placeData = data[6];
     if (!placeData)
         return undefined;

package/dist/services/transit.js.map

@@ -1 +1 @@
-{"version":3,"file":"transit.js","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ3F,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,MAAM,CAAc;IACpB,MAAM,CAAgB;IAE9B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAAoC;QAC7D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;SAC7B,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAA8B,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,KAAK,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAgC;QAC1D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,kBAAkB,EACjC,yBAAyB,CAAC;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CACH,CAAC;QACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,IAA8B;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAA8B,CAAC;IACvD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,0BAA0B,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"transit.js","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"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"}

package/dist/services/viewport.d.ts

@@ -0,0 +1,76 @@
+import { HttpClient } from '../client/http-client.js';
+import { type GMapsConfig } from '../types/common.js';
+import type { AdminRegion, GeoArea, NearbyAreasOptions, PassiveAssistOptions, PassiveAssistResult, RevealPlaceOptions, RevealPlaceResult } from '../types/viewport.js';
+/**
+ * Viewport-surface services: passive-assist chips, neighbourhood context, click reveal.
+ */
+export declare class PassiveAssistService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Viewport POI chips for the map camera (weather, events, neighbourhood labels).
+     *
+     * Needs an in-page viewport psi: bootstrap kEI / fetchSessionPsi tokens return
+     * the ~212 B cache-metadata stub, and only a token from a live viewport
+     * passiveassist request yields chips. Such a token is portable — it replays over
+     * plain Node fetch and stays valid for at least a few minutes — but minting one
+     * requires a browser, so pass `psi` yourself or supply a `psiProvider`. This
+     * service will not start a browser on your behalf.
+     */
+    getViewportChips(options: PassiveAssistOptions): Promise<PassiveAssistResult>;
+}
+/**
+ * Administrative context for a coordinate.
+ *
+ * Backed by reverse geocode — the only anonymous Maps surface that names the
+ * region hierarchy containing a point.
+ */
+export declare class LocationContextService {
+    private geocode;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Not available.
+     *
+     * Maps renders neighbourhood and district polygons from vector tiles rather
+     * than any queryable surface, and place search returns businesses instead of
+     * areas. Use {@link getRegions} for the administrative hierarchy.
+     *
+     * @throws {GMapsError} always
+     */
+    getNearby(_options: NearbyAreasOptions): Promise<GeoArea[]>;
+    /**
+     * Not available — alias of {@link getNearby}.
+     *
+     * @throws {GMapsError} always
+     */
+    getAreas(coordinates: {
+        lat: number;
+        lng: number;
+    }): Promise<GeoArea[]>;
+    /**
+     * Administrative regions containing a point, most specific first
+     * (e.g. `Bengaluru` → `Karnataka` → `India`).
+     *
+     * Reverse geocode names the hierarchy but reports no polygons, so
+     * {@link AdminRegion.bounds} is absent.
+     */
+    getRegions(coordinates: {
+        lat: number;
+        lng: number;
+    }): Promise<AdminRegion[]>;
+    private regionsFor;
+}
+export declare class RevealService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Reveal a hidden POI at a map click location.
+     * Requires a feature id (`ftid`) from search/suggest or place preview.
+     */
+    revealAtClick(options: RevealPlaceOptions): Promise<RevealPlaceResult>;
+}
+//# sourceMappingURL=viewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../src/services/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAMvK;;GAEG;AAEH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;;;;;;OASG;IACG,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoDpF;AAQD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAIjD;;;;;;;;OAQG;IACG,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOjE;;;;OAIG;IACG,QAAQ,CAAC,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI7E;;;;;;OAMG;IACG,UAAU,CAAC,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAarE,UAAU;CASzB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2B7E"}

package/dist/services/viewport.js

@@ -0,0 +1,180 @@
+import { extractAdminRegions, extractPassiveAssistChips } from '../parsers/viewport.js';
+import { buildPassiveAssistUrl } from '../rpc/feature-pb.js';
+import { GMapsError } from '../types/common.js';
+import { GeocodeService } from './geocode.js';
+import { extractRevealPlace } from '../parsers/reveal.js';
+import { buildRevealUrl, normalizeRevealFtid } from '../rpc/feature-pb.js';
+/**
+ * Viewport-surface services: passive-assist chips, neighbourhood context, click reveal.
+ */
+export class PassiveAssistService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Viewport POI chips for the map camera (weather, events, neighbourhood labels).
+     *
+     * Needs an in-page viewport psi: bootstrap kEI / fetchSessionPsi tokens return
+     * the ~212 B cache-metadata stub, and only a token from a live viewport
+     * passiveassist request yields chips. Such a token is portable — it replays over
+     * plain Node fetch and stays valid for at least a few minutes — but minting one
+     * requires a browser, so pass `psi` yourself or supply a `psiProvider`. This
+     * service will not start a browser on your behalf.
+     */
+    async getViewportChips(options) {
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        let psi = options.psi;
+        let url;
+        if (!psi && options.psiProvider) {
+            const minted = await options.psiProvider({
+                lat: options.lat,
+                lng: options.lng,
+                zoom: options.zoom,
+                hl,
+                gl,
+            });
+            if (typeof minted === 'string') {
+                psi = minted;
+            }
+            else {
+                psi = minted.psi;
+                url = minted.passiveAssistUrl;
+            }
+        }
+        if (!psi) {
+            throw new GMapsError('passiveassist needs an in-page viewport psi: pass `psi`, or a `psiProvider` ' +
+                '(see mintViewportPsi in scripts/lib/mint-viewport-psi.ts, which uses a headless browser). ' +
+                'Bootstrap tokens only return the cache-metadata stub.');
+        }
+        if (!url) {
+            url = buildPassiveAssistUrl({
+                lat: options.lat,
+                lng: options.lng,
+                zoom: options.zoom,
+                psi,
+                width: options.width,
+                height: options.height,
+                chipLimit: options.chipLimit,
+                hl,
+                gl,
+            });
+        }
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            allowShortBody: true,
+        });
+        return extractPassiveAssistChips(data);
+    }
+}
+/**
+ * Request regions to probe from. The first is used alone unless it comes back
+ * without a country, which happens when the point lies in that same country.
+ */
+const REGION_PROBE_ORDER = ['us', 'jp'];
+/**
+ * Administrative context for a coordinate.
+ *
+ * Backed by reverse geocode — the only anonymous Maps surface that names the
+ * region hierarchy containing a point.
+ */
+export class LocationContextService {
+    geocode;
+    constructor(http, config) {
+        this.geocode = new GeocodeService(http, config);
+    }
+    /**
+     * Not available.
+     *
+     * Maps renders neighbourhood and district polygons from vector tiles rather
+     * than any queryable surface, and place search returns businesses instead of
+     * areas. Use {@link getRegions} for the administrative hierarchy.
+     *
+     * @throws {GMapsError} always
+     */
+    async getNearby(_options) {
+        throw new GMapsError('Nearby area lookup is not exposed by any public Maps surface — ' +
+            'getRegions() returns the administrative hierarchy for a point.');
+    }
+    /**
+     * Not available — alias of {@link getNearby}.
+     *
+     * @throws {GMapsError} always
+     */
+    async getAreas(coordinates) {
+        return this.getNearby({ location: coordinates });
+    }
+    /**
+     * Administrative regions containing a point, most specific first
+     * (e.g. `Bengaluru` → `Karnataka` → `India`).
+     *
+     * Reverse geocode names the hierarchy but reports no polygons, so
+     * {@link AdminRegion.bounds} is absent.
+     */
+    async getRegions(coordinates) {
+        // Google omits the country when the request region matches the place's own,
+        // so probe from a second region and keep whichever answer is more complete.
+        let best = [];
+        for (const gl of REGION_PROBE_ORDER) {
+            const regions = await this.regionsFor(coordinates, gl);
+            if (regions.length > best.length)
+                best = regions;
+            // A full city → state → country chain is as much as this surface gives.
+            if (best.length >= 3)
+                break;
+        }
+        return best;
+    }
+    async regionsFor(coordinates, gl) {
+        const response = await this.geocode.reverseGeocode(coordinates.lat, coordinates.lng, { gl });
+        const result = response.result ?? response.alternatives[0];
+        if (!result)
+            return [];
+        return extractAdminRegions(result.plusCodeAddress ?? result.formattedAddress);
+    }
+}
+export class RevealService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Reveal a hidden POI at a map click location.
+     * Requires a feature id (`ftid`) from search/suggest or place preview.
+     */
+    async revealAtClick(options) {
+        if (!options.ftid) {
+            return {};
+        }
+        const url = buildRevealUrl({
+            camLat: options.camLat,
+            camLng: options.camLng,
+            camZoom: options.camZoom,
+            hitLat: options.hitLat,
+            hitLng: options.hitLng,
+            ftid: normalizeRevealFtid(options.ftid),
+            width: options.width,
+            height: options.height,
+            tileX: options.tileX,
+            tileY: options.tileY,
+            hl: this.hl,
+            gl: this.gl,
+        });
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+        });
+        return extractRevealPlace(data);
+    }
+}
+//# sourceMappingURL=viewport.js.map

package/dist/services/viewport.js.map

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

package/dist/services/waypoint-optimizer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Waypoint order optimization.
+ *
+ * Consumer Maps has no `optimize:true` equivalent, so this composes the
+ * anonymous directions-fan-out distance matrix with a travelling-salesman
+ * heuristic: nearest-neighbour construction followed by 2-opt improvement.
+ * Fixed origin/destination are respected; open tours (no fixed ends) try
+ * every stop as a starting point and keep the best tour after 2-opt.
+ */
+import { GeocodeService } from './geocode.js';
+import { DirectionsService } from './directions.js';
+import { DistanceMatrixService } from './distance-matrix.js';
+import type { OptimizeWaypointsOptions, OptimizeWaypointsResult } from '../types/route-optimization.js';
+export declare class WaypointOptimizerService {
+    private matrix;
+    private directions;
+    private geocode;
+    constructor(matrix: DistanceMatrixService, directions: DirectionsService, geocode: GeocodeService);
+    /**
+     * Reorder `stops` into an efficient visiting order.
+     *
+     * Costs come from real driving durations/distances via the directions
+     * fan-out matrix. With ~N stops the matrix costs N² unique pairs, so this
+     * suits up to roughly a dozen stops; larger lists still work but take
+     * proportionally longer.
+     */
+    optimize(options: OptimizeWaypointsOptions): Promise<OptimizeWaypointsResult>;
+    /** Coordinates for any node, geocoding address strings once. */
+    private resolve;
+}
+//# sourceMappingURL=waypoint-optimizer.d.ts.map

package/dist/services/waypoint-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waypoint-optimizer.d.ts","sourceRoot":"","sources":["../../src/services/waypoint-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,KAAK,EAEV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAiB;gBAG9B,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,cAAc;IAOzB;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgJnF,gEAAgE;YAClD,OAAO;CAStB"}