googlemaps-kit 0.1.0

package/dist/utils/static-map-grid.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Web Mercator tile grid math for static map composition.
+ *
+ * Pixel coordinates use the same 256 px tile grid as Google Maps basemap tiles.
+ * Fractional offsets within the origin tile centre the requested viewport.
+ */
+export declare const MAP_TILE_PX = 256;
+/** World pixel position at a zoom level (top-left origin). */
+export declare function latLngToWorldPixel(lat: number, lng: number, zoom: number): {
+    x: number;
+    y: number;
+};
+/** Inverse of {@link latLngToWorldPixel}. */
+export declare function worldPixelToLatLng(x: number, y: number, zoom: number): {
+    lat: number;
+    lng: number;
+};
+export interface TileGridPlan {
+    zoom: number;
+    /** Top-left corner of the output viewport in world pixels. */
+    worldLeft: number;
+    worldTop: number;
+    outputWidth: number;
+    outputHeight: number;
+    /** Inclusive tile index range to fetch. */
+    tileXStart: number;
+    tileYStart: number;
+    tileXEnd: number;
+    tileYEnd: number;
+    centerLat: number;
+    centerLng: number;
+}
+/** Compute tile coverage for a centre-based viewport. */
+export declare function planCenterViewport(params: {
+    lat: number;
+    lng: number;
+    zoom: number;
+    width: number;
+    height: number;
+    scale?: 1 | 2;
+}): TileGridPlan;
+/** Pick the highest zoom whose tile span fits the pixel dimensions. */
+export declare function zoomForBounds(sw: {
+    lat: number;
+    lng: number;
+}, ne: {
+    lat: number;
+    lng: number;
+}, width: number, height: number, scale?: 1 | 2): number;
+/** Compute tile coverage fitting a lat/lng bounding box. */
+export declare function planBoundsViewport(params: {
+    sw: {
+        lat: number;
+        lng: number;
+    };
+    ne: {
+        lat: number;
+        lng: number;
+    };
+    width: number;
+    height: number;
+    scale?: 1 | 2;
+}): TileGridPlan;
+/** Convert lat/lng to pixel coordinates within a planned viewport. */
+export declare function latLngToViewportPixel(lat: number, lng: number, plan: TileGridPlan): {
+    x: number;
+    y: number;
+};
+/** Viewport altitude (`!1d`) for embed pb builders. */
+export declare function viewportAltitude(lat: number, zoom: number): number;
+//# sourceMappingURL=static-map-grid.d.ts.map

package/dist/utils/static-map-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-map-grid.d.ts","sourceRoot":"","sources":["../../src/utils/static-map-grid.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1B;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf,GAAG,YAAY,CAkCf;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAChC,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,CAAC,GAAG,CAAK,GACf,MAAM,CAkBR;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf,GAAG,YAAY,CAaf;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAM1B;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/utils/static-map-grid.js

@@ -0,0 +1,103 @@
+/**
+ * Web Mercator tile grid math for static map composition.
+ *
+ * Pixel coordinates use the same 256 px tile grid as Google Maps basemap tiles.
+ * Fractional offsets within the origin tile centre the requested viewport.
+ */
+import { altitudeFromZoom } from './geo.js';
+export const MAP_TILE_PX = 256;
+/** World pixel position at a zoom level (top-left origin). */
+export function latLngToWorldPixel(lat, lng, zoom) {
+    const scale = 2 ** zoom;
+    const latRad = (lat * Math.PI) / 180;
+    return {
+        x: ((lng + 180) / 360) * scale * MAP_TILE_PX,
+        y: ((1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2) *
+            scale *
+            MAP_TILE_PX,
+    };
+}
+/** Inverse of {@link latLngToWorldPixel}. */
+export function worldPixelToLatLng(x, y, zoom) {
+    const scale = 2 ** zoom;
+    const n = Math.PI - (2 * Math.PI * y) / (scale * MAP_TILE_PX);
+    return {
+        lat: (180 / Math.PI) * Math.atan(0.5 * (Math.exp(n) - Math.exp(-n))),
+        lng: (x / (scale * MAP_TILE_PX)) * 360 - 180,
+    };
+}
+/** Compute tile coverage for a centre-based viewport. */
+export function planCenterViewport(params) {
+    const scale = params.scale ?? 1;
+    const effectiveZoom = params.zoom + (scale === 2 ? 1 : 0);
+    const outputWidth = params.width * scale;
+    const outputHeight = params.height * scale;
+    const center = latLngToWorldPixel(params.lat, params.lng, effectiveZoom);
+    const worldLeft = center.x - outputWidth / 2;
+    const worldTop = center.y - outputHeight / 2;
+    const tileXStart = Math.floor(worldLeft / MAP_TILE_PX);
+    const tileYStart = Math.floor(worldTop / MAP_TILE_PX);
+    const tileXEnd = Math.floor((worldLeft + outputWidth - 1) / MAP_TILE_PX);
+    const tileYEnd = Math.floor((worldTop + outputHeight - 1) / MAP_TILE_PX);
+    const centerLatLng = worldPixelToLatLng(worldLeft + outputWidth / 2, worldTop + outputHeight / 2, effectiveZoom);
+    return {
+        zoom: effectiveZoom,
+        worldLeft,
+        worldTop,
+        outputWidth,
+        outputHeight,
+        tileXStart,
+        tileYStart,
+        tileXEnd,
+        tileYEnd,
+        centerLat: centerLatLng.lat,
+        centerLng: centerLatLng.lng,
+    };
+}
+/** Pick the highest zoom whose tile span fits the pixel dimensions. */
+export function zoomForBounds(sw, ne, width, height, scale = 1) {
+    const outputWidth = width * scale;
+    const outputHeight = height * scale;
+    const minLat = Math.min(sw.lat, ne.lat);
+    const maxLat = Math.max(sw.lat, ne.lat);
+    const minLng = Math.min(sw.lng, ne.lng);
+    const maxLng = Math.max(sw.lng, ne.lng);
+    for (let z = 21; z >= 0; z--) {
+        const swPx = latLngToWorldPixel(minLat, minLng, z);
+        const nePx = latLngToWorldPixel(maxLat, maxLng, z);
+        const spanX = Math.abs(nePx.x - swPx.x);
+        const spanY = Math.abs(nePx.y - swPx.y);
+        if (spanX <= outputWidth && spanY <= outputHeight) {
+            return z - (scale === 2 ? 1 : 0);
+        }
+    }
+    return 0;
+}
+/** Compute tile coverage fitting a lat/lng bounding box. */
+export function planBoundsViewport(params) {
+    const scale = params.scale ?? 1;
+    const zoom = zoomForBounds(params.sw, params.ne, params.width, params.height, scale);
+    const centerLat = (params.sw.lat + params.ne.lat) / 2;
+    const centerLng = (params.sw.lng + params.ne.lng) / 2;
+    return planCenterViewport({
+        lat: centerLat,
+        lng: centerLng,
+        zoom,
+        width: params.width,
+        height: params.height,
+        scale,
+    });
+}
+/** Convert lat/lng to pixel coordinates within a planned viewport. */
+export function latLngToViewportPixel(lat, lng, plan) {
+    const world = latLngToWorldPixel(lat, lng, plan.zoom);
+    return {
+        x: Math.round(world.x - plan.worldLeft),
+        y: Math.round(world.y - plan.worldTop),
+    };
+}
+/** Viewport altitude (`!1d`) for embed pb builders. */
+export function viewportAltitude(lat, zoom) {
+    return altitudeFromZoom(zoom, lat);
+}
+//# sourceMappingURL=static-map-grid.js.map

package/dist/utils/static-map-grid.js.map

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

package/dist/utils/throttle-detection.d.ts

@@ -0,0 +1,17 @@
+/** listugcposts anonymous stub: `[null,null,null,null,null,1]`. */
+export declare function isListUgcUnauthenticatedStub(data: unknown): boolean;
+/** batchexecute auth stub: `[null,null,null,null,null,true]` (~199 B). */
+export declare function isBatchAuthStub(data: unknown): boolean;
+/** batchexecute application error envelope (e.g. `[3]`). */
+export declare function isBatchBlocked(data: unknown): boolean;
+/** HTTP 200 body that parses but carries no usable rows (cookieless batchexecute trap). */
+export declare function isEmptySuccessPayload(data: unknown): boolean;
+/** Google abuse-page markers in an HTTP 403 body. */
+export declare function isAutomatedQueryBlock(body: string): boolean;
+export type ThrottleKind = 'http-403' | 'http-429' | 'empty-200' | 'auth-stub' | 'batch-error';
+export declare function classifyThrottleFailure(options: {
+    status?: number;
+    bodyText?: string;
+    parsed?: unknown;
+}): ThrottleKind | undefined;
+//# sourceMappingURL=throttle-detection.d.ts.map

package/dist/utils/throttle-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle-detection.d.ts","sourceRoot":"","sources":["../../src/utils/throttle-detection.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAWnE;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAa5D;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,YAAY,GAAG,SAAS,CAY3B"}

package/dist/utils/throttle-detection.js

@@ -0,0 +1,71 @@
+import { isBatchErrorCode } from '../rpc/batch-rpc.js';
+/** listugcposts anonymous stub: `[null,null,null,null,null,1]`. */
+export function isListUgcUnauthenticatedStub(data) {
+    return (Array.isArray(data) &&
+        data.length >= 6 &&
+        data[0] === null &&
+        data[1] === null &&
+        data[2] === null &&
+        data[3] === null &&
+        data[4] === null &&
+        data[5] === 1);
+}
+/** batchexecute auth stub: `[null,null,null,null,null,true]` (~199 B). */
+export function isBatchAuthStub(data) {
+    if (!Array.isArray(data))
+        return false;
+    const json = JSON.stringify(data);
+    if (data.length === 6 && data[5] === true && json.length < 280)
+        return true;
+    if (json.length < 20)
+        return true;
+    return false;
+}
+/** batchexecute application error envelope (e.g. `[3]`). */
+export function isBatchBlocked(data) {
+    return isBatchErrorCode(data);
+}
+/** HTTP 200 body that parses but carries no usable rows (cookieless batchexecute trap). */
+export function isEmptySuccessPayload(data) {
+    if (data == null)
+        return true;
+    if (typeof data === 'string') {
+        const trimmed = data.trim();
+        return trimmed.length === 0 || trimmed === '[]' || trimmed === '[3]';
+    }
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return true;
+        if (isBatchErrorCode(data))
+            return true;
+        if (isListUgcUnauthenticatedStub(data))
+            return true;
+        if (isBatchAuthStub(data))
+            return true;
+    }
+    return false;
+}
+/** Google abuse-page markers in an HTTP 403 body. */
+export function isAutomatedQueryBlock(body) {
+    return (body.includes('automated queries') ||
+        body.includes("can't process your request right now"));
+}
+export function classifyThrottleFailure(options) {
+    if (options.status === 429)
+        return 'http-429';
+    if (options.status === 403 && options.bodyText && isAutomatedQueryBlock(options.bodyText)) {
+        return 'http-403';
+    }
+    if (options.parsed != null) {
+        if (isBatchBlocked(options.parsed))
+            return 'batch-error';
+        if (isListUgcUnauthenticatedStub(options.parsed))
+            return 'auth-stub';
+        if (isBatchAuthStub(options.parsed))
+            return 'auth-stub';
+        if (isEmptySuccessPayload(options.parsed))
+            return 'empty-200';
+    }
+    return undefined;
+}
+//# sourceMappingURL=throttle-detection.js.map

package/dist/utils/throttle-detection.js.map

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

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "googlemaps-kit",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Google Maps consumer HTTP surfaces",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "type-check": "tsc -p tsconfig.check.json --noEmit",
+    "prepublishOnly": "npm run type-check && npm test && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "preexample": "npm run build",
+    "example:quick-start": "tsx examples/quick-start.ts",
+    "example:search": "tsx examples/search-text.ts",
+    "example:pagination": "tsx examples/search-pagination.ts",
+    "example:place": "tsx examples/place-get.ts",
+    "example:place-full": "tsx examples/place-full.ts",
+    "example:reviews": "tsx examples/reviews-list.ts",
+    "example:directions": "tsx examples/directions-get.ts",
+    "example:geocode": "tsx examples/geocode.ts",
+    "example:suggest": "tsx examples/suggest.ts",
+    "example:maps-url": "tsx examples/maps-url.ts",
+    "examples:all": "npm run build && tsx examples/run-all.ts",
+    "verify:all": "tsx scripts/verify-all.ts",
+    "smoke:daily": "tsx scripts/smoke-daily.ts"
+  },
+  "keywords": [
+    "google-maps",
+    "maps",
+    "sdk",
+    "typescript",
+    "places",
+    "search",
+    "reviews",
+    "directions",
+    "geocode"
+  ],
+  "author": "Kumar Vandit",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KumarVandit/googlemaps-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/KumarVandit/googlemaps-kit/issues"
+  },
+  "homepage": "https://github.com/KumarVandit/googlemaps-kit#readme",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "geo-tz": "^8.1.8",
+    "undici": "^6.28.0"
+  }
+}