Tile-Map-Proxy

A Tile Map Proxy base on NodeJS Edge runtime. Provide a unified API that uses Google XYZ tile coordinates

It can be imported into the map browser as a custom map source. Ovital, ACGIS etc. Feature:

1. Resolve and optimize the tile map loading network. With the power of CloudFlare global CDN and cache.
2. Help people(Chinese) that after the GFW to access the world map service(Google etc.).
3. Smooth out the differences between each Tile API and provide Google XYZ-based Tile APIs in a unified format.
4. Provides a custom hander interface to handle possible limitations of some APIs. e.g. CORS/Header Referer/Cookie etc.

Deploy

It support Cloudflare Workers and Vercel Edge Functions and NodeJS Native !

Vercel:

Cloudflare:

Docker:

configure the docker mirror if u need:

sudo mkdir -p /etc/docker
sudo nano /etc/docker/daemon.json
{
    "registry-mirrors": [
        "https://dockerproxy.com",
        "https://docker.mirrors.ustc.edu.cn",
        "https://docker.nju.edu.cn"
    ]
}
sudo systemctl daemon-reload
sudo systemctl restart docker

build and setup:

docker build -t tile-map-proxy .
docker compose build
docker compose up -d
docker compose down --volumes --rmi all

# remove all unused resources
docker network prune
docker volume prune

Compatibility

This project is ueing latest NodeJS LTS(Long Time support) version(v20.13.1). And it use the es6 module system(not CommonJS) and TypeScript. So make sure your package.json have type: module and engines >=20.0.0

Develop

pnpm install

pnpm create hono my-app
pnpm add --save-dev --save-exact prettier
pnpm add -D typescript ts-node @types/node
pnpm add -g tsx

References

tsx: What is tsx?