googlemaps-kit 0.4.0 → 0.6.0

package/dist/services/geocode.js.map

@@ -1 +1 @@
-{"version":3,"file":"geocode.js","sourceRoot":"","sources":["../../src/services/geocode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AASvD,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAIhC,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAwB;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAE9B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE;YACnC,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,oBAAoB;SAC5C,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,GAAW,EACX,GAAW,EACX,OAA+B;QAE/B,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;YACjC,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,oBAAoB;SAC5C,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,KAAK,CACjB,KAAa,EACb,GAAW,EACX,GAAW,EACX,OAAsB;QAEtB,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,cAAc,CAAC;YACzB,KAAK;YACL,GAAG;YACH,GAAG;YACH,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,qBAAqB;YAC5D,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,kBAAkB;YACnD,YAAY,EAAE,OAAO,EAAE,YAAY;YACnC,MAAM,EAAE,CAAC;YACT,EAAE;YACF,EAAE;YACF,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE7E,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"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":"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"}

package/dist/services/keyed.js

@@ -0,0 +1,152 @@
+import { GMapsError } from '../types/common.js';
+function resolveApiKey(override, configKey, envKey, label) {
+    const key = override ?? configKey ?? envKey;
+    if (!key) {
+        throw new GMapsError(`${label ?? 'Service'} requires apiKey, client config, or environment variable`);
+    }
+    return key;
+}
+/** Roads — snapToRoads / nearestRoads (requires apiKey). */
+export class RoadsService {
+    http;
+    apiKey;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.apiKey = config.roadsApiKey ?? process.env.GMAPS_ROADS_API_KEY;
+    }
+    async snapToRoads(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Roads');
+        const path = options.path.map((p) => `${p.lat},${p.lng}`).join('|');
+        const params = new URLSearchParams({ path, interpolate: String(options.interpolate ?? false) });
+        const url = `https://roads.googleapis.com/v1/snapToRoads?${params.toString()}`;
+        const body = await this.http.get(url, {
+            extraHeaders: { 'X-Goog-Api-Key': key },
+            raw: true,
+            noRetry: true,
+        });
+        return JSON.parse(body);
+    }
+    async nearestRoads(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Roads');
+        const points = options.points.map((p) => `${p.lat},${p.lng}`).join('|');
+        const params = new URLSearchParams({ points });
+        const url = `https://roads.googleapis.com/v1/nearestRoads?${params.toString()}`;
+        const body = await this.http.get(url, {
+            extraHeaders: { 'X-Goog-Api-Key': key },
+            raw: true,
+            noRetry: true,
+        });
+        return JSON.parse(body);
+    }
+}
+/** Solar building insights (requires apiKey). */
+export class SolarService {
+    http;
+    apiKey;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.apiKey = config.solarApiKey ?? process.env.GMAPS_SOLAR_API_KEY;
+    }
+    async findClosestBuildingInsights(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Solar');
+        const params = new URLSearchParams({
+            'location.latitude': String(options.lat),
+            'location.longitude': String(options.lng),
+        });
+        const url = `https://solar.googleapis.com/v1/buildingInsights:findClosest?${params.toString()}`;
+        const body = await this.http.get(url, {
+            extraHeaders: { 'X-Goog-Api-Key': key },
+            raw: true,
+            noRetry: true,
+        });
+        return JSON.parse(body);
+    }
+}
+/** Pollen forecast (requires apiKey). */
+export class PollenService {
+    http;
+    apiKey;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.apiKey = config.pollenApiKey ?? process.env.GMAPS_POLLEN_API_KEY;
+    }
+    async lookupForecast(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Pollen');
+        const params = new URLSearchParams({
+            'location.latitude': String(options.lat),
+            'location.longitude': String(options.lng),
+            days: String(options.days ?? 1),
+        });
+        const url = `https://pollen.googleapis.com/v1/forecast:lookup?${params.toString()}`;
+        const body = await this.http.get(url, {
+            extraHeaders: { 'X-Goog-Api-Key': key },
+            raw: true,
+            noRetry: true,
+        });
+        return JSON.parse(body);
+    }
+}
+/** Address validation (requires apiKey). */
+export class AddressValidationService {
+    http;
+    apiKey;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.apiKey = config.addressValidationApiKey ?? process.env.GMAPS_ADDRESS_VALIDATION_API_KEY;
+    }
+    async validateAddress(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Address Validation');
+        const url = 'https://addressvalidation.googleapis.com/v1:validateAddress';
+        const payload = {
+            address: {
+                addressLines: options.addressLines,
+                regionCode: options.regionCode,
+            },
+        };
+        const body = await this.httpPostJson(url, payload, key);
+        return JSON.parse(body);
+    }
+    async httpPostJson(url, payload, apiKey) {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Goog-Api-Key': apiKey,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            throw new GMapsError(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.text();
+    }
+}
+/** WiFi/cell geolocation (requires apiKey). */
+export class GeolocationService {
+    apiKey;
+    constructor(_http, config = {}) {
+        this.apiKey = config.geolocationApiKey ?? process.env.GMAPS_GEOLOCATION_API_KEY;
+    }
+    async geolocate(options) {
+        const key = resolveApiKey(options.apiKey, this.apiKey, undefined, 'Geolocation');
+        const url = `https://www.googleapis.com/geolocation/v1/geolocate?key=${encodeURIComponent(key)}`;
+        const body = await this.httpPostJson(url, {
+            considerIp: options.considerIp,
+            wifiAccessPoints: options.wifiAccessPoints,
+            cellTowers: options.cellTowers,
+        });
+        return JSON.parse(body);
+    }
+    async httpPostJson(url, payload) {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            throw new GMapsError(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.text();
+    }
+}
+//# sourceMappingURL=keyed.js.map

package/dist/services/keyed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.js","sourceRoot":"","sources":["../../src/services/keyed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAElE,SAAS,aAAa,CACpB,QAAiB,EACjB,SAAkB,EAClB,MAAe,EACf,KAAc;IAEd,MAAM,GAAG,GAAG,QAAQ,IAAI,SAAS,IAAI,MAAM,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,UAAU,CAClB,GAAG,KAAK,IAAI,SAAS,0DAA0D,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4DAA4D;AAC5D,MAAM,OAAO,YAAY;IACf,IAAI,CAAa;IACjB,MAAM,CAAU;IAExB,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAIjB;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,GAAG,GAAG,+CAA+C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC/E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,YAAY,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAGlB;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,gDAAgD,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,YAAY,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,iDAAiD;AACjD,MAAM,OAAO,YAAY;IACf,IAAI,CAAa;IACjB,MAAM,CAAU;IAExB,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,OAIjC;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACxC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,gEAAgE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAChG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,YAAY,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,aAAa;IAChB,IAAI,CAAa;IACjB,MAAM,CAAU;IAExB,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAKpB;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACxC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACzC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;SAChC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,oDAAoD,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,YAAY,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,OAAO,wBAAwB;IAC3B,IAAI,CAAa;IACjB,MAAM,CAAU;IAExB,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAIrB;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,6DAA6D,CAAC;QAC1E,MAAM,OAAO,GAAG;YACd,OAAO,EAAE;gBACP,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B;SACF,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,OAAgB,EAAE,MAAc;QACtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM;aACzB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAU;IAExB,YAAY,KAAiB,EAAE,SAAsB,EAAE;QACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAWf;QACC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,2DAA2D,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE;YACxC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,OAAgB;QACtD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/services/knowledge.d.ts

@@ -2,6 +2,9 @@ import { HttpClient } from '../client/http-client.js';
 import type { GMapsConfig, KnowledgeEntity, PlaceDetails } from '../types/common.js';
 export interface GetKnowledgeOptions {
     hexId: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
     ftid?: string;
     placeId?: string;
     /** Use place preview fields when the RPC surface is unavailable. */
@@ -16,10 +19,11 @@ export declare class KnowledgeService {
     constructor(http: HttpClient, config: GMapsConfig);
     /**
      * Fetch knowledge entity data for a place.
-     * By default uses place-preview fallback — getknowledgeentity returns HTTP 400 for every
-     * pb variant and the path is absent from captured JS (no client-side pb builder to imitate).
+     * When `fallbackDetails` is omitted, fetches a live place preview and derives facts from
+     * categories and amenities — getknowledgeentity returns HTTP 400 for every pb variant.
      */
     get(options: GetKnowledgeOptions): Promise<KnowledgeEntity | null>;
+    private fetchPreviewDetails;
     private fromPlaceDetails;
 }
 //# sourceMappingURL=knowledge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/services/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAMtD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGrF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoCxE,OAAO,CAAC,gBAAgB;CAOzB"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/services/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIrF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;YAsC1D,mBAAmB;IAwBjC,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/services/knowledge.js

@@ -1,5 +1,7 @@
+import { extractPlaceDetails } from '../parsers/place.js';
 import { extractKnowledgeEntity, extractKnowledgeFromPlaceDetails, } from '../parsers/knowledge.js';
-import { buildKnowledgeUrl } from '../rpc/pb-builders.js';
+import { buildKnowledgeUrl, buildPlaceUrl } from '../rpc/pb-builders.js';
+import { buildPlaceReferer } from '../utils/place-ref.js';
 export class KnowledgeService {
     http;
     hl;
@@ -11,8 +13,8 @@ export class KnowledgeService {
     }
     /**
      * Fetch knowledge entity data for a place.
-     * By default uses place-preview fallback — getknowledgeentity returns HTTP 400 for every
-     * pb variant and the path is absent from captured JS (no client-side pb builder to imitate).
+     * When `fallbackDetails` is omitted, fetches a live place preview and derives facts from
+     * categories and amenities — getknowledgeentity returns HTTP 400 for every pb variant.
      */
     async get(options) {
         if (options.fallbackDetails && options.tryRpc !== true) {
@@ -42,11 +44,34 @@ export class KnowledgeService {
                 // RPC unavailable — use fallback below
             }
         }
-        if (options.fallbackDetails) {
-            return this.fromPlaceDetails(options.fallbackDetails);
+        const fallback = options.fallbackDetails ?? (await this.fetchPreviewDetails(options));
+        if (fallback) {
+            return this.fromPlaceDetails(fallback);
         }
         return null;
     }
+    async fetchPreviewDetails(options) {
+        try {
+            const url = buildPlaceUrl({
+                hexId: options.hexId,
+                ftid: options.ftid,
+                name: options.name,
+                lat: options.lat,
+                lng: options.lng,
+                hl: this.hl,
+                gl: this.gl,
+                mode: 'live',
+            });
+            const data = await this.http.get(url, {
+                referer: buildPlaceReferer(options.name),
+                includeOrigin: true,
+            });
+            return extractPlaceDetails(data);
+        }
+        catch {
+            return null;
+        }
+    }
     fromPlaceDetails(details) {
         const entity = extractKnowledgeFromPlaceDetails(details);
         if (entity.name || entity.description || entity.facts?.length) {

package/dist/services/knowledge.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/services/knowledge.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAc1D,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,OAA4B;QACpC,IAAI,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;oBACpC,OAAO,EAAE,8BAA8B;oBACvC,aAAa,EAAE,IAAI;oBACnB,cAAc,EAAE,IAAI;oBACpB,OAAO,EAAE,IAAI;iBACd,CAAW,CAAC;gBACb,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;oBAC9D,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,gBAAgB,CAAC,OAAqB;QAC5C,MAAM,MAAM,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/services/knowledge.ts"],"names":[],"mappings":"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"}

package/dist/services/lists.d.ts

@@ -1,11 +1,17 @@
 import { HttpClient } from '../client/http-client.js';
 import { type GMapsConfig } from '../types/common.js';
-import type { GetListOptions, PlaceList } from '../types/lists.js';
+import type { GetListOptions, ListBrowseOptions, PlaceList, PlaceListSummary } from '../types/lists.js';
 export declare class ListsService {
     private http;
     private hl;
     private gl;
+    private config;
     constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Browse public lists (featured, trending, new).
+     * Returns list summaries; `itemCount` is included only when Google publishes it.
+     */
+    list(options?: ListBrowseOptions): Promise<PlaceListSummary[]>;
     /**
      * Fetch and parse a public/shared place list.
      * Accepts `listId` or `url` in options — resolves short links automatically.

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

@@ -1 +1 @@
-{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/services/lists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnE,qBAAa,YAAY;IACvB,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,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBtD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBtD"}
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/services/lists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAUtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAc;gBAEhB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAOjD;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuCpE;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBtD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBtD"}

package/dist/services/lists.js

@@ -1,14 +1,58 @@
 import { assertListNotErrorEnvelope, extractListIdFromPageHtml, extractPlaceList, parseListIdFromInput, } from '../parsers/lists.js';
-import { buildGetListUrl } from '../rpc/lists-pb.js';
+import { buildGetListUrl } from '../rpc/feature-pb.js';
+import { createRpcClient } from '../rpc/batch-rpc.js';
 import { GMapsError } from '../types/common.js';
+import { safeGet } from '../utils/payload.js';
 export class ListsService {
     http;
     hl;
     gl;
+    config;
     constructor(http, config) {
         this.http = http;
         this.hl = config.hl ?? 'en';
         this.gl = config.gl ?? 'us';
+        this.config = config;
+    }
+    /**
+     * Browse public lists (featured, trending, new).
+     * Returns list summaries; `itemCount` is included only when Google publishes it.
+     */
+    async list(options) {
+        const psi = 'anonymous';
+        const rpc = await createRpcClient(this.http, this.config);
+        const category = options?.category ?? 'featured';
+        const categoryCode = category === 'trending' ? 1 : category === 'new' ? 2 : 0;
+        const data = await rpc.call('/MapsListsService.BrowseLists', [
+            { psi },
+            [categoryCode],
+        ]);
+        // Extract list summaries from response [1][*]: [id, title, itemCount?, ownerName?, …]
+        const results = [];
+        const listsArray = safeGet(data, 1);
+        if (Array.isArray(listsArray)) {
+            for (const item of listsArray) {
+                if (!Array.isArray(item))
+                    continue;
+                const id = safeGet(item, 0);
+                const title = safeGet(item, 1);
+                if (!id || !title)
+                    continue;
+                const summary = {
+                    id,
+                    title,
+                    isPublic: true,
+                };
+                const itemCount = safeGet(item, 2);
+                if (typeof itemCount === 'number')
+                    summary.itemCount = itemCount;
+                const ownerName = safeGet(item, 3);
+                if (ownerName)
+                    summary.ownerName = ownerName;
+                results.push(summary);
+            }
+        }
+        return results;
     }
     /**
      * Fetch and parse a public/shared place list.

package/dist/services/lists.js.map

@@ -1 +1 @@
-{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/services/lists.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAIlE,MAAM,OAAO,YAAY;IACf,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAuB;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAEjC,MAAM,GAAG,GAAG,eAAe,CAAC;YAC1B,MAAM;YACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,EAAE;YACF,EAAE;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;YAC5C,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC;YAChC,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,gBAAgB,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,QAAQ,EAAE;YACjD,OAAO,EAAE,8BAA8B;YACvC,GAAG,EAAE,IAAI;YACT,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,+CAA+C,MAAM,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,WAAW,GAAG,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/services/lists.ts"],"names":[],"mappings":"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"}

package/dist/services/map-3d.d.ts

@@ -0,0 +1,66 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { Building3d, Map3dBuildingsOptions, Map3dMeshOptions, Map3dMeshResult, Map3dTerrainOptions, Terrain3dResult } from '../types/map-3d.js';
+/**
+ * Photorealistic 3D buildings and terrain.
+ *
+ * Maps renders 3D from Google Earth's "rocktree" octree at
+ * `kh.google.com/rt/earth` — the same mesh the Photorealistic 3D Tiles API
+ * bills for, served here without a key. Metadata arrives as an oriented
+ * bounding-box tree (`BulkMetadata`); each leaf publishes a `NodeData` payload
+ * holding a delta-packed vertex cube, a triangle strip and a 512×512 JPEG.
+ * See {@link file://src/rpc/earth-rocktree.ts} for the wire format.
+ *
+ * The mesh is *fused*: buildings, ground and vegetation are one surface, so
+ * {@link Map3dService.getBuildings} segments structures out of it rather than
+ * reading a building layer. Treat those footprints as derived, not authored.
+ */
+export declare class Map3dService {
+    private http;
+    /** Per-planet root epochs and reference radii (rocktree serves earth, mars, moon). */
+    private planetoids;
+    private bulkCache;
+    constructor(http: HttpClient, _config: GMapsConfig);
+    private fetchProto;
+    private getPlanetoid;
+    private getBulk;
+    /**
+     * Walk the octree towards a point until the node's ground sampling distance
+     * meets `targetMetersPerTexel`, returning the finest node that carries mesh.
+     *
+     * Sibling octants overlap — their boxes hug the terrain shell instead of
+     * tiling space — so a point can sit inside several boxes at one level and
+     * only one of those branches continues to street-level detail. The walk
+     * therefore tries candidates most-central first and backtracks instead of
+     * committing to the first hit.
+     */
+    private descend;
+    private descendBulk;
+    /**
+     * Fetch the photorealistic mesh covering `bounds`.
+     *
+     * Sampling walks a grid of probe points across the box so a request wider
+     * than one octree node still returns every node it touches, deduped by path.
+     */
+    getMesh(options: Map3dMeshOptions): Promise<Map3dMeshResult>;
+    private fetchTile;
+    /**
+     * Sample the mesh into a height grid.
+     *
+     * Heights come off the photorealistic surface, so they include buildings and
+     * tree canopy. For bare ground use a low `detail` — coarse nodes carry
+     * terrain only.
+     */
+    getTerrain(options: Map3dTerrainOptions): Promise<Terrain3dResult>;
+    /**
+     * Segment building-like structures out of the fused mesh.
+     *
+     * The octree publishes no building layer, so this rasterises mesh vertices
+     * into a 4 m grid, estimates local ground from the low percentile of a
+     * neighbourhood window, and groups connected cells that stand `minHeight`
+     * above it. Outlines are convex hulls of the occupied cells — massing, not
+     * surveyed footprints.
+     */
+    getBuildings(options: Map3dBuildingsOptions): Promise<Building3d[]>;
+}
+//# sourceMappingURL=map-3d.d.ts.map

package/dist/services/map-3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-3d.d.ts","sourceRoot":"","sources":["../../src/services/map-3d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuBtD,OAAO,KAAK,EACV,UAAU,EAEV,qBAAqB,EAErB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EAGnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAoF5B;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,sFAAsF;IACtF,OAAO,CAAC,UAAU,CAAoE;IACtF,OAAO,CAAC,SAAS,CAA0C;gBAE/C,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW;YAIpC,UAAU;YAaV,YAAY;YAeZ,OAAO;IAcrB;;;;;;;;;OASG;YACW,OAAO;YAWP,WAAW;IAyEzB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YA6CpD,SAAS;IAsEvB;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BxE;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CA8G1E"}