googlemaps-kit 0.1.0

package/dist/services/search.d.ts

@@ -0,0 +1,25 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig, PlaceDetails, SearchOptions, SearchPageResult, SearchResult, SearchTextOptions, SearchTextResult } from '../types/common.js';
+/** Lift a search row into the PlaceDetails shape used by places.get callers. */
+export declare function searchResultToPlaceDetails(row: SearchResult): PlaceDetails;
+export declare class SearchService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    search(options: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Places API (New) Text Search equivalent — one HTTP call.
+     *
+     * Search rows already carry Enterprise fields (hours, phone, attributes, photo,
+     * rating, place id). Prefer this over search + N× places.get when you need the
+     * same shape official `places:searchText` returns with a field mask.
+     */
+    searchText(options: SearchTextOptions): Promise<SearchTextResult>;
+    /** Search with pagination metadata (psi, next offset). */
+    searchPage(options: SearchOptions): Promise<SearchPageResult>;
+    searchAll(options: SearchOptions & {
+        maxPages?: number;
+    }): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAG5B,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAqB1E;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;IAM3C,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK7D;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAavE,0DAA0D;IACpD,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuC7D,SAAS,CACb,OAAO,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,YAAY,EAAE,CAAC;CAqC3B"}

package/dist/services/search.js

@@ -0,0 +1,130 @@
+import { applyClientSearchFilters } from '../parsers/search-client-filters.js';
+import { extractBusinesses } from '../parsers/search.js';
+import { extractSearchPagination } from '../parsers/search-pagination.js';
+import { buildSearchUrl } from '../rpc/pb-builders.js';
+/** Lift a search row into the PlaceDetails shape used by places.get callers. */
+export function searchResultToPlaceDetails(row) {
+    return {
+        name: row.name,
+        address: row.address,
+        placeId: row.placeId,
+        hexId: row.hexId,
+        ftid: row.ftid,
+        rating: row.rating,
+        reviewCount: row.reviewCount,
+        priceLevel: row.priceLevel,
+        latitude: row.latitude,
+        longitude: row.longitude,
+        phone: row.internationalPhone ?? row.phone,
+        website: row.website,
+        categories: row.categories,
+        openStatus: row.openStatus,
+        openingSchedule: row.openingSchedule,
+        attributeGroups: row.attributeGroups,
+        timezone: row.timezone,
+        photos: row.photos ?? (row.thumbnailUrl ? [row.thumbnailUrl] : undefined),
+    };
+}
+export class SearchService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    async search(options) {
+        const page = await this.searchPage(options);
+        return page.results;
+    }
+    /**
+     * Places API (New) Text Search equivalent — one HTTP call.
+     *
+     * Search rows already carry Enterprise fields (hours, phone, attributes, photo,
+     * rating, place id). Prefer this over search + N× places.get when you need the
+     * same shape official `places:searchText` returns with a field mask.
+     */
+    async searchText(options) {
+        const fieldMask = options.fieldMask ?? 'enterprise';
+        const start = performance.now();
+        const page = await this.searchPage(options);
+        return {
+            places: page.results,
+            requestCount: 1,
+            timingMs: performance.now() - start,
+            fieldMask,
+            pagination: page.pagination,
+        };
+    }
+    /** Search with pagination metadata (psi, next offset). */
+    async searchPage(options) {
+        const pageSize = options.limit ?? 20;
+        const offset = options.offset ?? 0;
+        const url = buildSearchUrl({
+            query: options.query,
+            lat: options.location.lat,
+            lng: options.location.lng,
+            resultsCount: pageSize,
+            maxRadius: options.radiusMeters ?? 150_000,
+            viewportDist: options.viewportDist,
+            offset,
+            hl: this.hl,
+            gl: this.gl,
+            psi: options.psi,
+            ech: options.ech ?? Math.floor(offset / pageSize) + 1,
+            zoom: options.zoom,
+        });
+        const data = await this.http.get(url);
+        let results = extractBusinesses(data);
+        if (options.filters) {
+            results = applyClientSearchFilters(results, options.filters);
+        }
+        const paginationMeta = extractSearchPagination(data, offset, pageSize);
+        const psi = paginationMeta.psi ?? options.psi;
+        return {
+            results,
+            pagination: {
+                offset,
+                pageSize,
+                psi,
+                nextOffset: paginationMeta.hasMore ? paginationMeta.nextOffset : undefined,
+                hasMore: paginationMeta.hasMore ?? false,
+            },
+        };
+    }
+    async searchAll(options) {
+        const pageSize = options.limit ?? 20;
+        const maxPages = options.maxPages ?? 5;
+        const all = [];
+        const seen = new Set();
+        let offset = options.offset ?? 0;
+        let psi = options.psi;
+        let ech = options.ech ?? 1;
+        for (let page = 0; page < maxPages; page++) {
+            const batch = await this.searchPage({
+                ...options,
+                limit: pageSize,
+                offset,
+                psi,
+                ech,
+            });
+            if (batch.results.length === 0)
+                break;
+            for (const biz of batch.results) {
+                const key = biz.placeId ?? biz.hexId ?? biz.name;
+                if (key && !seen.has(key)) {
+                    seen.add(key);
+                    all.push(biz);
+                }
+            }
+            if (!batch.pagination.hasMore || batch.pagination.nextOffset == null)
+                break;
+            offset = batch.pagination.nextOffset;
+            psi = batch.pagination.psi ?? psi;
+            ech++;
+        }
+        return all;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/services/search.js.map

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

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

@@ -0,0 +1,14 @@
+import { HttpClient } from '../client/http-client.js';
+import { type GMapsConfig } from '../types/common.js';
+import type { StaticMapBoundsOptions, StaticMapOptions, StaticMapResult } from '../types/static-map.js';
+export declare class StaticMapService {
+    private tiles;
+    private fetchDelayMs;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /** Render a static map centred on lat/lng. */
+    getStaticMap(options: StaticMapOptions): Promise<StaticMapResult>;
+    /** Render a static map fitted to a bounding box. */
+    getStaticMapForBounds(options: StaticMapBoundsOptions): Promise<StaticMapResult>;
+    private renderPlan;
+}
+//# sourceMappingURL=static-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-map.d.ts","sourceRoot":"","sources":["../../src/services/static-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EACV,sBAAsB,EAEtB,gBAAgB,EAEhB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAuBhC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAKjD,8CAA8C;IACxC,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAavE,oDAAoD;IAC9C,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;YAYxE,UAAU;CA4DzB"}

package/dist/services/static-map.js

@@ -0,0 +1,182 @@
+import { GMapsError } from '../types/common.js';
+import { blitRgba, createRgbaCanvas, cropRgba, decodePng, encodePng, } from '../utils/png.js';
+import { pooled, sleep } from '../utils/pooled.js';
+import { latLngToViewportPixel, MAP_TILE_PX, planBoundsViewport, planCenterViewport, } from '../utils/static-map-grid.js';
+import { TilesService } from './tiles.js';
+const DEFAULT_CONCURRENCY = 8;
+const DEFAULT_FETCH_DELAY_MS = 0;
+const MAX_TILES = 25;
+export class StaticMapService {
+    tiles;
+    fetchDelayMs;
+    constructor(http, config) {
+        this.tiles = new TilesService(http, config);
+        this.fetchDelayMs = DEFAULT_FETCH_DELAY_MS;
+    }
+    /** Render a static map centred on lat/lng. */
+    async getStaticMap(options) {
+        validateDimensions(options.width, options.height);
+        const plan = planCenterViewport({
+            lat: options.lat,
+            lng: options.lng,
+            zoom: options.zoom,
+            width: options.width,
+            height: options.height,
+            scale: options.scale,
+        });
+        return this.renderPlan(plan, options);
+    }
+    /** Render a static map fitted to a bounding box. */
+    async getStaticMapForBounds(options) {
+        validateDimensions(options.width, options.height);
+        const plan = planBoundsViewport({
+            sw: options.sw,
+            ne: options.ne,
+            width: options.width,
+            height: options.height,
+            scale: options.scale,
+        });
+        return this.renderPlan(plan, options);
+    }
+    async renderPlan(plan, options) {
+        const tileCount = (plan.tileXEnd - plan.tileXStart + 1) * (plan.tileYEnd - plan.tileYStart + 1);
+        if (tileCount > MAX_TILES) {
+            throw new GMapsError(`Static map requires ${tileCount} tiles (max ${MAX_TILES}) — reduce size or zoom`);
+        }
+        const concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
+        const delayMs = options.fetchDelayMs ?? this.fetchDelayMs;
+        const mosaicWidth = (plan.tileXEnd - plan.tileXStart + 1) * MAP_TILE_PX;
+        const mosaicHeight = (plan.tileYEnd - plan.tileYStart + 1) * MAP_TILE_PX;
+        const mosaicImage = createRgbaCanvas(mosaicWidth, mosaicHeight, [0xe8, 0xea, 0xe8, 255]);
+        const tileCoords = [];
+        for (let ty = plan.tileYStart; ty <= plan.tileYEnd; ty++) {
+            for (let tx = plan.tileXStart; tx <= plan.tileXEnd; tx++) {
+                tileCoords.push({ x: tx, y: ty });
+            }
+        }
+        let fetched = 0;
+        await pooled(tileCoords, concurrency, async (coord) => {
+            if (fetched > 0)
+                await sleep(delayMs);
+            const tile = await this.tiles.getTile({ z: plan.zoom, x: coord.x, y: coord.y });
+            fetched++;
+            const decoded = decodePng(tile.bytes);
+            const dx = (coord.x - plan.tileXStart) * MAP_TILE_PX;
+            const dy = (coord.y - plan.tileYStart) * MAP_TILE_PX;
+            blitRgba(mosaicImage, decoded, dx, dy);
+        });
+        const cropX = Math.round(plan.worldLeft - plan.tileXStart * MAP_TILE_PX);
+        const cropY = Math.round(plan.worldTop - plan.tileYStart * MAP_TILE_PX);
+        let output = cropRgba(mosaicImage, cropX, cropY, plan.outputWidth, plan.outputHeight);
+        if (options.path) {
+            output = drawPath(output, options.path, plan);
+        }
+        if (options.markers) {
+            for (const marker of options.markers) {
+                output = drawMarker(output, marker, plan);
+            }
+        }
+        const bytes = encodePng(output);
+        return {
+            bytes,
+            width: plan.outputWidth,
+            height: plan.outputHeight,
+            zoom: plan.zoom,
+            center: { lat: plan.centerLat, lng: plan.centerLng },
+            tilesFetched: tileCoords.length,
+        };
+    }
+}
+function validateDimensions(width, height) {
+    if (width < 1 || height < 1 || width > 1280 || height > 1280) {
+        throw new GMapsError('Static map width/height must be between 1 and 1280');
+    }
+}
+function drawMarker(image, marker, plan) {
+    const { x, y } = latLngToViewportPixel(marker.lat, marker.lng, plan);
+    if (x < 0 || y < 0 || x >= image.width || y >= image.height) {
+        return image;
+    }
+    const style = marker.style ?? 'pin';
+    const color = marker.color ?? [234, 67, 53, 255];
+    if (style === 'circle') {
+        const radius = marker.radius ?? 6;
+        fillCircle(image, x, y, radius, color);
+        return image;
+    }
+    fillCircle(image, x, y - 4, 7, color);
+    fillCircle(image, x, y - 4, 5, [255, 255, 255, 255]);
+    fillCircle(image, x, y - 4, 3, color);
+    fillTriangle(image, x, y + 2, 6, color);
+    return image;
+}
+function drawPath(image, path, plan) {
+    if (path.points.length < 2)
+        return image;
+    const color = path.color ?? [66, 133, 244, 255];
+    const width = path.width ?? 3;
+    for (let i = 1; i < path.points.length; i++) {
+        const a = path.points[i - 1];
+        const b = path.points[i];
+        const p0 = latLngToViewportPixel(a.lat, a.lng, plan);
+        const p1 = latLngToViewportPixel(b.lat, b.lng, plan);
+        drawLine(image, p0.x, p0.y, p1.x, p1.y, width, color);
+    }
+    return image;
+}
+function fillCircle(image, cx, cy, radius, color) {
+    const r2 = radius * radius;
+    for (let dy = -radius; dy <= radius; dy++) {
+        for (let dx = -radius; dx <= radius; dx++) {
+            if (dx * dx + dy * dy > r2)
+                continue;
+            setPixel(image, cx + dx, cy + dy, color);
+        }
+    }
+}
+function fillTriangle(image, cx, cy, halfWidth, color) {
+    for (let row = 0; row <= halfWidth; row++) {
+        const w = halfWidth - row;
+        for (let dx = -w; dx <= w; dx++) {
+            setPixel(image, cx + dx, cy + row, color);
+        }
+    }
+}
+function drawLine(image, x0, y0, x1, y1, strokeWidth, color) {
+    const dx = Math.abs(x1 - x0);
+    const dy = Math.abs(y1 - y0);
+    const sx = x0 < x1 ? 1 : -1;
+    const sy = y0 < y1 ? 1 : -1;
+    let err = dx - dy;
+    let x = x0;
+    let y = y0;
+    const half = Math.floor(strokeWidth / 2);
+    while (true) {
+        for (let oy = -half; oy <= half; oy++) {
+            for (let ox = -half; ox <= half; ox++) {
+                setPixel(image, x + ox, y + oy, color);
+            }
+        }
+        if (x === x1 && y === y1)
+            break;
+        const e2 = 2 * err;
+        if (e2 > -dy) {
+            err -= dy;
+            x += sx;
+        }
+        if (e2 < dx) {
+            err += dx;
+            y += sy;
+        }
+    }
+}
+function setPixel(image, x, y, color) {
+    if (x < 0 || y < 0 || x >= image.width || y >= image.height)
+        return;
+    const idx = (y * image.width + x) * 4;
+    image.data[idx] = color[0];
+    image.data[idx + 1] = color[1];
+    image.data[idx + 2] = color[2];
+    image.data[idx + 3] = color[3];
+}
+//# sourceMappingURL=static-map.js.map

package/dist/services/static-map.js.map

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

package/dist/services/suggest.d.ts

@@ -0,0 +1,12 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { SuggestOptions, SuggestResult } from '../types/suggest.js';
+export declare class SuggestService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /** Maps omnibox autocomplete — query completions and place suggestions. */
+    suggest(options: SuggestOptions): Promise<SuggestResult>;
+}
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/services/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,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,2EAA2E;IACrE,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAyB/D"}

package/dist/services/suggest.js

@@ -0,0 +1,36 @@
+import { extractSuggestions } from '../parsers/suggest.js';
+import { buildSuggestUrl, DEFAULT_SUGGEST_LAT, DEFAULT_SUGGEST_LNG, } from '../rpc/suggest-pb.js';
+export class SuggestService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /** Maps omnibox autocomplete — query completions and place suggestions. */
+    async suggest(options) {
+        const lat = options.lat ?? DEFAULT_SUGGEST_LAT;
+        const lng = options.lng ?? DEFAULT_SUGGEST_LNG;
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        const url = buildSuggestUrl({
+            query: options.query,
+            lat,
+            lng,
+            altitude: options.altitude,
+            zoom: options.zoom,
+            screenWidth: options.screenWidth,
+            screenHeight: options.screenHeight,
+            hl,
+            gl,
+            sessionToken: options.sessionToken,
+        });
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+        });
+        return extractSuggestions(data, { raw: options.raw });
+    }
+}
+//# sourceMappingURL=suggest.js.map

package/dist/services/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../src/services/suggest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAI9B,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,2EAA2E;IAC3E,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC;QAC/C,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,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG;YACH,GAAG;YACH,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,EAAE;YACF,EAAE;YACF,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,GAAG,EAAE;YAC7C,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/services/tiles.d.ts

@@ -0,0 +1,19 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { MapIconFetchOptions, MapIconResult, MapTileFetchOptions, MapTileLatLngOptions, MapTileResult } from '../types/tiles.js';
+export declare class TilesService {
+    private http;
+    constructor(http: HttpClient, _config: GMapsConfig);
+    /** Fetch a basemap tile by Web Mercator z/x/y indices. */
+    getTile(options: MapTileFetchOptions): Promise<MapTileResult>;
+    /** Fetch a basemap tile by lat/lng (Web Mercator indices computed internally). */
+    getTileByLatLng(options: MapTileLatLngOptions): Promise<MapTileResult>;
+    /** Build a basemap tile URL (no network I/O). */
+    buildTileUrl(options: MapTileFetchOptions): string;
+    /** Build a POI icon URL (no network I/O). */
+    buildIconUrl(options: MapIconFetchOptions): string;
+    /** Fetch a POI icon PNG from `/maps/vt/icon/`. */
+    getIcon(options?: Partial<MapIconFetchOptions>): Promise<MapIconResult>;
+    private decodeTile;
+}
+//# sourceMappingURL=tiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/services/tiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW;IAIlD,0DAA0D;IACpD,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAenE,kFAAkF;IAC5E,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAM5E,iDAAiD;IACjD,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAIlD,6CAA6C;IAC7C,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAIlD,kDAAkD;IAC5C,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB7E,OAAO,CAAC,UAAU;CAuBnB"}

package/dist/services/tiles.js

@@ -0,0 +1,77 @@
+import { GMapsParseError } from '../types/common.js';
+import { readPngDimensions, unwrapTilePng } from '../parsers/tiles.js';
+import { buildIconUrl, buildMapTileUrl, DEFAULT_POI_ICON, } from '../rpc/tiles-pb.js';
+import { webMercatorTile } from '../utils/geo.js';
+export class TilesService {
+    http;
+    constructor(http, _config) {
+        this.http = http;
+    }
+    /** Fetch a basemap tile by Web Mercator z/x/y indices. */
+    async getTile(options) {
+        const url = buildMapTileUrl(options);
+        const { bytes: envelope, contentType } = await this.http.getBytes(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            minBytes: 100,
+        });
+        return this.decodeTile(envelope, contentType, {
+            z: options.z,
+            x: options.x,
+            y: options.y,
+        });
+    }
+    /** Fetch a basemap tile by lat/lng (Web Mercator indices computed internally). */
+    async getTileByLatLng(options) {
+        const { lat, lng, zoom, ...rest } = options;
+        const { x, y } = webMercatorTile(lat, lng, zoom);
+        return this.getTile({ ...rest, z: zoom, x, y });
+    }
+    /** Build a basemap tile URL (no network I/O). */
+    buildTileUrl(options) {
+        return buildMapTileUrl(options);
+    }
+    /** Build a POI icon URL (no network I/O). */
+    buildIconUrl(options) {
+        return buildIconUrl(options);
+    }
+    /** Fetch a POI icon PNG from `/maps/vt/icon/`. */
+    async getIcon(options) {
+        const name = options?.name ?? DEFAULT_POI_ICON;
+        const url = buildIconUrl({ name, scale: options?.scale });
+        const { bytes, contentType } = await this.http.getBytes(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+            allowShortBody: true,
+            minBytes: 50,
+        });
+        const dimensions = readPngDimensions(bytes);
+        if (!dimensions) {
+            throw new GMapsParseError('Icon response is not a valid PNG');
+        }
+        return {
+            bytes,
+            contentType,
+            width: dimensions.width,
+            height: dimensions.height,
+        };
+    }
+    decodeTile(envelope, contentType, coordinates) {
+        const png = unwrapTilePng(envelope);
+        if (!png) {
+            throw new GMapsParseError('Tile response does not contain a PNG image');
+        }
+        const dimensions = readPngDimensions(png);
+        if (!dimensions) {
+            throw new GMapsParseError('Extracted tile PNG has invalid IHDR');
+        }
+        return {
+            bytes: png,
+            contentType,
+            width: dimensions.width,
+            height: dimensions.height,
+            coordinates,
+        };
+    }
+}
+//# sourceMappingURL=tiles.js.map

package/dist/services/tiles.js.map

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

package/dist/services/timezone.d.ts

@@ -0,0 +1,19 @@
+import { GeocodeService } from './geocode.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { TimezoneOptions, TimezoneResult } from '../types/timezone.js';
+export declare class TimezoneService {
+    private geocode;
+    private hl;
+    private gl;
+    constructor(geocode: GeocodeService, config: GMapsConfig);
+    /**
+     * Resolve IANA timezone for coordinates.
+     *
+     * Default path is offline `geo-tz` polygon lookup (~1 ms) — matches Time Zone API
+     * latency without a network hop. Pass `source: 'geocode'` to force Google's
+     * `[14][30]` field via reverse (+ optional forward) geocode (~240–860 ms).
+     */
+    get(options: TimezoneOptions, at?: Date): Promise<TimezoneResult>;
+    private getFromGeocode;
+}
+//# sourceMappingURL=timezone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/services/timezone.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO5E,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"}