Skip to content

Repository files navigation

3D Earth Exporter Preview

🌍 Google Earth 3D Exporter CLI

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.


✨ Features

  • 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

📦 Requirements

Before you get started, make sure you have the following installed:


🚀 Getting Started

Clone the repository:

git clone https://github.com/your-username/node-earth-export.git
cd node-earth-export

Install dependencies:

npm install

🗺️ Exporting 3D Area

You 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.

3D Earth Exporter Preview

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'

🛠 Build Standalone Binary

You can compile the entire project into a single executable file for your platform.

npm install -g pkg
npm run pkg

This will produce binaries for macOS, Windows, and Linux in the build/ directory:

./build/earth-exporter-macos
./build/earth-exporter-win.exe
./build/earth-exporter-linux

Now you can use it without installing Node.js:

./build/earth-exporter-macos --bbox="..."

📸 Screenshots

Exported Model Preview Exported Model Preview Exported Model Preview Exported Model Preview Exported Model Preview

🙏 Credits

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages