googlemaps-kit 0.5.0 → 0.7.0

package/dist/services/elevation.js

@@ -5,23 +5,27 @@ const MICRO_ROUTE_OFFSET = 0.002;
 export class ElevationService {
     http;
     directions;
+    panorama;
     hl;
     gl;
-    constructor(http, directions, config) {
+    constructor(http, directions, panorama, config) {
         this.http = http;
         this.directions = directions;
+        this.panorama = panorama;
         this.hl = config.hl ?? 'en';
         this.gl = config.gl ?? 'us';
     }
     /**
-     * Point elevation via a short bicycling directions lookup.
-     * No dedicated elevation RPC on consumer Maps — Google embeds stats in bicycling
-     * directions at route `[0][16][2]`. One preview hit (no scrape / no retry sleeps).
+     * Point elevation — panorama photometa first, then bicycling directions fallback.
+     * Consumer Maps has no dedicated elevation RPC; directions embed stats at `[0][16][2]`.
      */
     async getAtPoint(options) {
         const hl = options.hl ?? this.hl;
         const gl = options.gl ?? this.gl;
         const start = performance.now();
+        const fromPanorama = await this.tryPanoramaElevation(options.lat, options.lng, hl, gl, start);
+        if (fromPanorama)
+            return fromPanorama;
         try {
             const dest = {
                 lat: options.lat + MICRO_ROUTE_OFFSET,
@@ -146,5 +150,36 @@ export class ElevationService {
             return fallback.raw;
         throw new Error('Directions request returned no elevation-bearing payload');
     }
+    async tryPanoramaElevation(lat, lng, hl, gl, startedAt) {
+        try {
+            const meta = await this.panorama.getByLocation(lat, lng, { hl, gl });
+            if (!meta)
+                return null;
+            if (meta.elevationMeters != null) {
+                return {
+                    lat,
+                    lng,
+                    status: 'OK',
+                    elevationMeters: meta.elevationMeters,
+                    source: 'panorama-sea-level',
+                    timingMs: performance.now() - startedAt,
+                };
+            }
+            if (meta.ellipsoidalHeightMeters != null) {
+                return {
+                    lat,
+                    lng,
+                    status: 'OK',
+                    elevationMeters: meta.ellipsoidalHeightMeters,
+                    source: 'panorama-ellipsoidal',
+                    timingMs: performance.now() - startedAt,
+                };
+            }
+        }
+        catch {
+            return null;
+        }
+        return null;
+    }
 }
 //# sourceMappingURL=elevation.js.map

package/dist/services/elevation.js.map

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

package/dist/services/environment/air-quality.d.ts

@@ -0,0 +1,39 @@
+import { HttpClient } from '../../client/http-client.js';
+import type { GMapsConfig } from '../../types/common.js';
+export interface AirQualityIndex {
+    aqi?: number;
+    category?: string;
+    dominantPollutant?: string;
+    displayName?: string;
+}
+export interface AirQualityLookupResult {
+    indexes?: AirQualityIndex[];
+    regionCode?: string;
+    dateTime?: string;
+    raw?: unknown;
+}
+export interface AirQualityLookupOptions {
+    lat: number;
+    lng: number;
+    apiKey?: string;
+}
+export declare class AirQualityService {
+    private http;
+    private tiles;
+    private defaultApiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /** Point air quality lookup when apiKey is set. Heatmap tiles are keyless via getHeatmapTile(). */
+    lookup(options: AirQualityLookupOptions): Promise<AirQualityLookupResult>;
+    /** AQI heatmap raster tile (keyless vt overlay). */
+    getHeatmapTile(options: {
+        z: number;
+        x: number;
+        y: number;
+    }): Promise<import("../../advanced.js").MapTileResult>;
+    /**
+     * Parse batchexecute GivvBd response when available via features().airQuality().
+     * Layout is reverse-engineered from nested numeric fields — may omit fields on sparse payloads.
+     */
+    parseBatchexecuteResponse(data: unknown): AirQualityLookupResult;
+}
+//# sourceMappingURL=air-quality.d.ts.map

package/dist/services/environment/air-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"air-quality.d.ts","sourceRoot":"","sources":["../../../src/services/environment/air-quality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAMtD,mGAAmG;IAC7F,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkB/E,oDAAoD;IAC9C,cAAc,CAAC,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IASjE;;;OAGG;IACH,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB;CAGjE"}

package/dist/services/environment/air-quality.js

@@ -0,0 +1,82 @@
+import { TilesService } from '../tiles.js';
+import { GMapsError } from '../../types/common.js';
+import { safeGet } from '../../utils/payload.js';
+export class AirQualityService {
+    http;
+    tiles;
+    defaultApiKey;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.tiles = new TilesService(http, config);
+        this.defaultApiKey = config.airQualityApiKey ?? process.env.GMAPS_AIR_QUALITY_API_KEY;
+    }
+    /** Point air quality lookup when apiKey is set. Heatmap tiles are keyless via getHeatmapTile(). */
+    async lookup(options) {
+        const apiKey = options.apiKey ?? this.defaultApiKey;
+        if (!apiKey) {
+            throw new GMapsError('Air Quality point lookup requires apiKey, config.airQualityApiKey, or GMAPS_AIR_QUALITY_API_KEY. ' +
+                'For heatmap tiles use getHeatmapTile(); for batchexecute use sdk().features().airQuality() with cookies.');
+        }
+        const data = await this.http.postJson('https://airquality.googleapis.com/v1/currentConditions:lookup', {
+            location: { latitude: options.lat, longitude: options.lng },
+        }, {
+            extraHeaders: { 'X-Goog-Api-Key': apiKey },
+            noRetry: true,
+        });
+        return parseAirQualityApiResponse(data);
+    }
+    /** AQI heatmap raster tile (keyless vt overlay). */
+    async getHeatmapTile(options) {
+        return this.tiles.getOverlay({
+            z: options.z,
+            x: options.x,
+            y: options.y,
+            layer: 'airQualityHeatmap',
+        });
+    }
+    /**
+     * Parse batchexecute GivvBd response when available via features().airQuality().
+     * Layout is reverse-engineered from nested numeric fields — may omit fields on sparse payloads.
+     */
+    parseBatchexecuteResponse(data) {
+        return parseAirQualityBatchexecute(data);
+    }
+}
+function parseAirQualityApiResponse(data) {
+    const indexesRaw = data.indexes;
+    const indexes = [];
+    if (Array.isArray(indexesRaw)) {
+        for (const entry of indexesRaw) {
+            if (!entry || typeof entry !== 'object')
+                continue;
+            const row = entry;
+            indexes.push({
+                aqi: typeof row.aqi === 'number' ? row.aqi : undefined,
+                category: typeof row.category === 'string' ? row.category : undefined,
+                dominantPollutant: typeof row.dominantPollutant === 'string' ? row.dominantPollutant : undefined,
+                displayName: typeof row.displayName === 'string' ? row.displayName : undefined,
+            });
+        }
+    }
+    return {
+        indexes,
+        regionCode: typeof data.regionCode === 'string' ? data.regionCode : undefined,
+        dateTime: typeof data.dateTime === 'string' ? data.dateTime : undefined,
+        raw: data,
+    };
+}
+function parseAirQualityBatchexecute(data) {
+    const aqi = safeGet(data, 1, 0, 0);
+    const category = safeGet(data, 1, 0, 1);
+    const pollutant = safeGet(data, 1, 0, 2);
+    const indexes = [];
+    if (aqi != null) {
+        indexes.push({
+            aqi,
+            category,
+            dominantPollutant: pollutant,
+        });
+    }
+    return { indexes, raw: data };
+}
+//# sourceMappingURL=air-quality.js.map

package/dist/services/environment/air-quality.js.map

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

package/dist/services/environment/weather.d.ts

@@ -0,0 +1,42 @@
+import type { GMapsConfig } from '../../types/common.js';
+import { HttpClient } from '../../client/http-client.js';
+import type { PassiveAssistOptions } from '../../types/viewport.js';
+export interface WeatherCurrentConditions {
+    temperature?: {
+        value?: number;
+        unit?: 'CELSIUS' | 'FAHRENHEIT';
+        display?: string;
+    };
+    weatherCondition?: {
+        description?: string;
+        iconUrl?: string;
+    };
+    isDaytime?: boolean;
+}
+export interface WeatherApiResponse {
+    currentConditions?: WeatherCurrentConditions;
+    timeZone?: {
+        id?: string;
+    };
+}
+export interface WeatherLookupOptions extends PassiveAssistOptions {
+    apiKey?: string;
+}
+export declare class WeatherService {
+    private passiveAssist;
+    private http;
+    private defaultApiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /** Current conditions from viewport passive-assist chips. */
+    getCurrentConditions(options: WeatherLookupOptions): Promise<WeatherApiResponse>;
+    /** Daily forecast when apiKey is configured; follows Google's page token contract. */
+    lookupForecast(options: {
+        lat: number;
+        lng: number;
+        apiKey?: string;
+        days?: number;
+        pageSize?: number;
+        pageToken?: string;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=weather.d.ts.map

package/dist/services/environment/weather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.d.ts","sourceRoot":"","sources":["../../../src/services/environment/weather.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,gBAAgB,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAMtD,6DAA6D;IACvD,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BtF,sFAAsF;IAChF,cAAc,CAAC,OAAO,EAAE;QAC5B,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,OAAO,CAAC;CAyBrB"}

package/dist/services/environment/weather.js

@@ -0,0 +1,63 @@
+import { PassiveAssistService } from '../viewport.js';
+import { GMapsError } from '../../types/common.js';
+export class WeatherService {
+    passiveAssist;
+    http;
+    defaultApiKey;
+    constructor(http, config = {}) {
+        this.passiveAssist = new PassiveAssistService(http, config);
+        this.http = http;
+        this.defaultApiKey = config.weatherApiKey ?? process.env.GMAPS_WEATHER_API_KEY;
+    }
+    /** Current conditions from viewport passive-assist chips. */
+    async getCurrentConditions(options) {
+        const chips = await this.passiveAssist.getViewportChips(options);
+        const weatherChip = chips.chips.find((c) => c.weatherTemp != null || c.weatherLabel != null);
+        if (!weatherChip) {
+            return {};
+        }
+        const tempMatch = weatherChip.weatherTemp?.match(/^(-?\d+(?:\.\d+)?)/);
+        const value = tempMatch ? Number(tempMatch[1]) : undefined;
+        const isFahrenheit = weatherChip.weatherTemp?.includes('°F');
+        return {
+            currentConditions: {
+                temperature: {
+                    value,
+                    unit: isFahrenheit ? 'FAHRENHEIT' : weatherChip.weatherTemp?.includes('°C') ? 'CELSIUS' : undefined,
+                    display: weatherChip.weatherTemp,
+                },
+                weatherCondition: {
+                    description: weatherChip.weatherLabel,
+                    iconUrl: weatherChip.weatherIconUrl,
+                },
+            },
+        };
+    }
+    /** Daily forecast when apiKey is configured; follows Google's page token contract. */
+    async lookupForecast(options) {
+        const apiKey = options.apiKey ?? this.defaultApiKey;
+        if (!apiKey) {
+            throw new GMapsError('Weather API requires apiKey, config.weatherApiKey, or GMAPS_WEATHER_API_KEY');
+        }
+        const params = new URLSearchParams();
+        params.set('location.latitude', String(options.lat));
+        params.set('location.longitude', String(options.lng));
+        for (const [name, value] of [['days', options.days], ['pageSize', options.pageSize]]) {
+            if (value !== undefined) {
+                if (!Number.isInteger(value) || value < 1 || value > 10)
+                    throw new RangeError(`${name} must be an integer between 1 and 10`);
+                params.set(name, String(value));
+            }
+        }
+        if (options.pageToken !== undefined)
+            params.set('pageToken', options.pageToken);
+        const url = `https://weather.googleapis.com/v1/forecast/days:lookup?${params.toString()}`;
+        const body = await this.http.get(url, {
+            extraHeaders: { 'X-Goog-Api-Key': apiKey },
+            raw: true,
+            noRetry: true,
+        });
+        return JSON.parse(body);
+    }
+}
+//# sourceMappingURL=weather.js.map

package/dist/services/environment/weather.js.map

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

package/dist/services/geocode.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from '../client/http-client.js';
-import type { GMapsConfig } from '../types/common.js';
+import type { Coordinates, GMapsConfig, LocationRef } from '../types/common.js';
 import type { GeocodeOptions, GeocodeResponse, ReverseGeocodeOptions } from '../types/geocode.js';
 import type { TimezoneOptions, TimezoneResult } from '../types/geocode.js';
 export declare class GeocodeService {
@@ -9,6 +9,10 @@ export declare class GeocodeService {
     constructor(http: HttpClient, config: GMapsConfig);
     /** Forward geocode: address string → coordinates and place metadata. */
     geocode(address: string, options?: GeocodeOptions): Promise<GeocodeResponse>;
+    /**
+     * Coords, `"lat,lng"` text, or a place/address geocoded to a pin (first hit).
+     */
+    resolveBias(near: LocationRef): Promise<Coordinates>;
     /**
      * Reverse geocode: coordinates → nearest place / Plus Code address.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"geocode.d.ts","sourceRoot":"","sources":["../../src/services/geocode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGlG,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAc3E,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD,wEAAwE;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAelF;;;;;OAKG;IACG,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC;YAQb,KAAK;CA4BpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW;IAMxD;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,GAAE,IAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;YAwBrE,cAAc;CAuD7B"}
+{"version":3,"file":"geocode.d.ts","sourceRoot":"","sources":["../../src/services/geocode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIlG,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAc3E,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD,wEAAwE;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAelF;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAU1D;;;;;OAKG;IACG,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC;YAQb,KAAK;CA4BpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW;IAMxD;;;;;;OAMG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,GAAE,IAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;YAwBrE,cAAc;CAuD7B"}

package/dist/services/geocode.js

@@ -1,5 +1,6 @@
 import { extractGeocodeResults, toGeocodeResponse } from '../parsers/geocode.js';
 import { buildSearchUrl } from '../rpc/pb-builders.js';
+import { resolveBiasCenter } from '../utils/place-ref.js';
 import { find as findTimezones } from 'geo-tz';
 import { buildTimezoneResult, extractTimezoneFromGeocodeResults, localityQueriesFromReverseHit, } from '../parsers/geocode.js';
 const DEFAULT_RESULTS_COUNT = 1;
@@ -28,6 +29,18 @@ export class GeocodeService {
             zoom: options?.zoom ?? DEFAULT_FORWARD_ZOOM,
         });
     }
+    /**
+     * Coords, `"lat,lng"` text, or a place/address geocoded to a pin (first hit).
+     */
+    async resolveBias(near) {
+        return resolveBiasCenter(near, async (query) => {
+            const { result } = await this.geocode(query);
+            if (result == null || !Number.isFinite(result.lat) || !Number.isFinite(result.lng)) {
+                return null;
+            }
+            return { lat: result.lat, lng: result.lng };
+        });
+    }
     /**
      * Reverse geocode: coordinates → nearest place / Plus Code address.
      *

package/dist/services/geocode.js.map

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

package/dist/services/keyed.d.ts

@@ -0,0 +1,80 @@
+import { HttpClient } from '../client/http-client.js';
+import { type GMapsConfig } from '../types/common.js';
+/** Roads — snapToRoads / nearestRoads (requires apiKey). */
+export declare class RoadsService {
+    private http;
+    private apiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    snapToRoads(options: {
+        path: Array<{
+            lat: number;
+            lng: number;
+        }>;
+        interpolate?: boolean;
+        apiKey?: string;
+    }): Promise<unknown>;
+    nearestRoads(options: {
+        points: Array<{
+            lat: number;
+            lng: number;
+        }>;
+        apiKey?: string;
+    }): Promise<unknown>;
+}
+/** Solar building insights (requires apiKey). */
+export declare class SolarService {
+    private http;
+    private apiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    findClosestBuildingInsights(options: {
+        lat: number;
+        lng: number;
+        apiKey?: string;
+    }): Promise<unknown>;
+}
+/** Pollen forecast (requires apiKey). */
+export declare class PollenService {
+    private http;
+    private apiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    lookupForecast(options: {
+        lat: number;
+        lng: number;
+        days?: number;
+        apiKey?: string;
+    }): Promise<unknown>;
+}
+/** Address validation (requires apiKey). */
+export declare class AddressValidationService {
+    private http;
+    private apiKey?;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    validateAddress(options: {
+        addressLines: string[];
+        regionCode?: string;
+        apiKey?: string;
+    }): Promise<unknown>;
+    private httpPostJson;
+}
+/** WiFi/cell geolocation (requires apiKey). */
+export declare class GeolocationService {
+    private apiKey?;
+    constructor(_http: HttpClient, config?: GMapsConfig);
+    geolocate(options: {
+        considerIp?: boolean;
+        wifiAccessPoints?: Array<{
+            macAddress: string;
+            signalStrength?: number;
+        }>;
+        cellTowers?: Array<{
+            cellId: number;
+            locationAreaCode: number;
+            mobileCountryCode: number;
+            mobileNetworkCode: number;
+            signalStrength?: number;
+        }>;
+        apiKey?: string;
+    }): Promise<unknown>;
+    private httpPostJson;
+}
+//# sourceMappingURL=keyed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.d.ts","sourceRoot":"","sources":["../../src/services/keyed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiBlE,4DAA4D;AAC5D,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKhD,WAAW,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IAad,YAAY,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;CAYrB;AAED,iDAAiD;AACjD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKhD,2BAA2B,CAAC,OAAO,EAAE;QACzC,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;CAcrB;AAED,yCAAyC;AACzC,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKhD,cAAc,CAAC,OAAO,EAAE;QAC5B,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;CAerB;AAED,4CAA4C;AAC5C,qBAAa,wBAAwB;IACnC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKhD,eAAe,CAAC,OAAO,EAAE;QAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;YAaN,YAAY;CAc3B;AAED,+CAA+C;AAC/C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,KAAK,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAIjD,SAAS,CAAC,OAAO,EAAE;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,gBAAgB,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1E,UAAU,CAAC,EAAE,KAAK,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,gBAAgB,EAAE,MAAM,CAAC;YACzB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;YAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;YAWN,YAAY;CAW3B"}