A powerful command-line tool for exporting textured 3D data from Google Earth using octant-based tiles. Works out of the box for macOS, Windows and Linux — either via local development or prebuilt binaries.
- Export high-quality textured 3D geometry from Google Earth
- Octant-based selection for accurate region export
- Built-in CLI for cross-platform use
- Written in TypeScript for better maintainability and type safety
- Based on the excellent work of retroplasma/earth-reverse-engineering
Before you get started, make sure you have the following installed:
Clone the repository:
git clone https://github.com/your-username/node-earth-export.git
cd node-earth-exportInstall dependencies:
npm installYou can export a region using latitude and longitude bounds.
Note
📌 Note: Google Earth uses octants to load tiles. You can enable octant grid via:
View > Show Grid or press Cmd + G / Ctrl + G. The area for export is formed by two diagonal corners of the bounding box as in the example in the photo below.
To run export you have to paste coordinates as following:
--bbox='SouthWest,NorthEast'(--bbox='minLat,minLng,maxLat,maxLng')
For example:
--bbox='43.72247467873372,10.392798185348513,43.72386257277956,10.396832227706911'
You can select exported aria and copy valid coordinates, using this tools: Map Bridge Web Interface, OSM Export
Run:
Use bbox format
npx ts-node ./src/index.ts --bbox='43.72247467873372,10.392798185348513,43.72386257277956,10.396832227706911'You can compile the entire project into a single executable file for your platform.
npm install -g pkg
npm run pkgThis will produce binaries for macOS, Windows, and Linux in the build/ directory:
./build/earth-exporter-macos
./build/earth-exporter-win.exe
./build/earth-exporter-linuxNow you can use it without installing Node.js:
./build/earth-exporter-macos --bbox="..."- Based on retroplasma/earth-reverse-engineering
- Thanks to contributors and the open-source GIS/3D tooling community!






