googlemaps-kit 0.6.0 → 0.7.0

package/dist/services/aerial-view.js

@@ -1,107 +0,0 @@
-import { GMapsError } from '../types/common.js';
-const AERIAL_VIEW_BASE = 'https://aerialview.googleapis.com/v1';
-export class AerialViewService {
-    http;
-    defaultApiKey;
-    constructor(http, config = {}) {
-        this.http = http;
-        this.defaultApiKey =
-            config.aerialViewApiKey ?? process.env.GMAPS_AERIAL_VIEW_API_KEY;
-    }
-    /** Check whether a cinematic aerial video exists for an address (requires apiKey). */
-    async lookupMetadata(options) {
-        return this.call('videos:lookupVideoMetadata', options);
-    }
-    /**
-     * Fetch short-lived video URIs for an address or stored video id.
-     * Call on every display — URIs expire quickly.
-     */
-    async lookupVideo(options) {
-        return this.call('videos:lookupVideo', options);
-    }
-    /** Request rendering when lookup returns 404 / not found. */
-    async renderVideo(options) {
-        const apiKey = this.resolveApiKey(options.apiKey);
-        const params = new URLSearchParams();
-        params.set('address', options.address);
-        const url = `${AERIAL_VIEW_BASE}/videos:renderVideo?${params.toString()}`;
-        try {
-            const body = await this.http.get(url, {
-                extraHeaders: { 'X-Goog-Api-Key': apiKey },
-                raw: true,
-                noRetry: true,
-                referer: 'https://mapsplatform.google.com/',
-            });
-            return this.parsePayload(JSON.parse(body));
-        }
-        catch (error) {
-            return this.errorResult(error);
-        }
-    }
-    async call(method, options) {
-        const apiKey = this.resolveApiKey(options.apiKey);
-        if (!options.address && !options.videoId) {
-            throw new GMapsError('Aerial View lookup requires address or videoId');
-        }
-        const params = new URLSearchParams();
-        if (options.address)
-            params.set('address', options.address);
-        if (options.videoId)
-            params.set('videoId', options.videoId);
-        const url = `${AERIAL_VIEW_BASE}/${method}?${params.toString()}`;
-        try {
-            const body = await this.http.get(url, {
-                extraHeaders: { 'X-Goog-Api-Key': apiKey },
-                raw: true,
-                noRetry: true,
-                referer: 'https://mapsplatform.google.com/',
-            });
-            return this.parsePayload(JSON.parse(body));
-        }
-        catch (error) {
-            return this.errorResult(error);
-        }
-    }
-    resolveApiKey(override) {
-        const key = override ?? this.defaultApiKey;
-        if (!key) {
-            throw new GMapsError('Aerial View requires apiKey (options.apiKey, config.aerialViewApiKey, or GMAPS_AERIAL_VIEW_API_KEY).');
-        }
-        return key;
-    }
-    parsePayload(data) {
-        if (!data || typeof data !== 'object') {
-            return { state: 'PROCESSING', error: 'Empty aerial view response' };
-        }
-        const record = data;
-        if (record.error && typeof record.error === 'object') {
-            const err = record.error;
-            return {
-                state: 'PROCESSING',
-                error: String(err.message ?? 'Aerial view request failed'),
-                statusCode: typeof err.code === 'number' ? err.code : undefined,
-            };
-        }
-        const state = record.state === 'ACTIVE' || record.state === 'PROCESSING'
-            ? record.state
-            : 'PROCESSING';
-        const metadata = record.metadata && typeof record.metadata === 'object'
-            ? record.metadata
-            : undefined;
-        const uris = record.uris && typeof record.uris === 'object'
-            ? record.uris
-            : undefined;
-        return { state, metadata, uris };
-    }
-    errorResult(error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const statusMatch = /HTTP (\d+)/.exec(message);
-        const statusCode = statusMatch ? Number(statusMatch[1]) : undefined;
-        return {
-            state: 'PROCESSING',
-            error: message,
-            statusCode,
-        };
-    }
-}
-//# sourceMappingURL=aerial-view.js.map

package/dist/services/aerial-view.js.map

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

package/dist/types/aerial-view.d.ts

@@ -1,39 +0,0 @@
-/** Processing state returned by the Aerial View API. */
-export type AerialViewState = 'ACTIVE' | 'PROCESSING';
-/** Supported video container formats in lookupVideo responses. */
-export type AerialViewFormat = 'IMAGE' | 'MP4_LOW' | 'MP4_MEDIUM' | 'MP4_HIGH' | 'HLS' | 'DASH';
-export interface AerialViewOrientationUris {
-    landscapeUri?: string;
-    portraitUri?: string;
-}
-export interface AerialViewCaptureDate {
-    year?: number;
-    month?: number;
-    day?: number;
-}
-export interface AerialViewMetadata {
-    videoId?: string;
-    captureDate?: AerialViewCaptureDate;
-    duration?: string;
-}
-export interface AerialViewLookupResult {
-    state: AerialViewState;
-    uris?: Partial<Record<AerialViewFormat, AerialViewOrientationUris>>;
-    metadata?: AerialViewMetadata;
-    /** Present when the video is not found or 3D imagery is unavailable. */
-    error?: string;
-    statusCode?: number;
-}
-export interface AerialViewLookupOptions {
-    /** US postal address — mutually exclusive with videoId when both omitted. */
-    address?: string;
-    /** Stored video id from a prior lookup or renderVideo call. */
-    videoId?: string;
-    /** Google Cloud API key — required; no keyless consumer endpoint exists. */
-    apiKey?: string;
-}
-export interface AerialViewRenderOptions {
-    address: string;
-    apiKey?: string;
-}
-//# sourceMappingURL=aerial-view.d.ts.map

package/dist/types/aerial-view.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aerial-view.d.ts","sourceRoot":"","sources":["../../src/types/aerial-view.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEtD,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,SAAS,GACT,YAAY,GACZ,UAAU,GACV,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/aerial-view.js

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

package/dist/types/aerial-view.js.map

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