{"id":21707784,"url":"https://github.com/flightaware/baremaps-exporter","last_synced_at":"2026-04-15T18:01:54.567Z","repository":{"id":199738906,"uuid":"688758386","full_name":"flightaware/baremaps-exporter","owner":"flightaware","description":"A fast golang exporter for tilesets created with Apache Baremaps","archived":false,"fork":false,"pushed_at":"2026-01-26T05:31:33.000Z","size":100,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":17,"default_branch":"main","last_synced_at":"2026-01-26T19:59:06.638Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flightaware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-09-08T03:33:30.000Z","updated_at":"2026-01-26T05:29:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"dd243293-3d45-49c8-918c-0c8de53e864d","html_url":"https://github.com/flightaware/baremaps-exporter","commit_stats":null,"previous_names":["flightaware/baremaps-exporter"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/flightaware/baremaps-exporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flightaware%2Fbaremaps-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flightaware%2Fbaremaps-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flightaware%2Fbaremaps-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flightaware%2Fbaremaps-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flightaware","download_url":"https://codeload.github.com/flightaware/baremaps-exporter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flightaware%2Fbaremaps-exporter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31853279,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-25T22:19:15.396Z","updated_at":"2026-04-15T18:01:54.559Z","avatar_url":"https://github.com/flightaware.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# baremaps-exporter\n\n`baremaps-exporter` is a golang drop-in replacement for the `baremaps export`\ncommand from [Apache Baremaps\n(incubator)](https://github.com/apache/incubator-baremaps). This exporter can\nbe up to 10-15x faster at exporting large tilesets.\n\nWritten in golang, baremaps-exporter exports vector tiles from a PostGIS\ndatabase. It can export either as `.mvt` mapbox vector tile files or as\n`.mbtiles` archives.\n\nAs input, the exporter requires a `tiles.json` file generated by [Apache\nBaremaps](https://github.com/apache/incubator-baremaps). These `tiles.json`\nfiles include the queries for each tile layer and zoom level, which\n`baremaps-exporter` uses to generate the tiles.\n\nThe `tiles.json` file can be extracted from baremaps when the server is\nrunning in dev mode. It is typically at `http://localhost:9000/tiles.json`. \n\n`baremaps-exporter` requires a database source name (DSN) connection string.\nThis is typically of the format\n`postgresql://localhost:5432/baremaps?\u0026user=baremaps\u0026password=baremaps`, or\nwherever your database is hosted.\n\nThe exporter will automatically detect if the output location ends in\n`.mbtiles` and switch to mbtiles output format.\n\n## Install\n\nGo must be installed, version 1.25 or later.\n\nThen:\n\n```\ngo install github.com/flightaware/baremaps-exporter/v2/cmd/baremaps-exporter\n```\n\nNow you're ready to go.\n\n## Usage\n\nRun the application with:\n```\nbaremaps-exporter --help\n```\n\nAll of the options:\n```\nexport baremaps-compatible tilesets from a postgis server\nUsage: baremaps-exporter [--output OUTPUT] [--mbtiles] [--dsn DSN] [--init INIT] [--workers WORKERS] [--batch BATCH] [--tileversion TILEVERSION] [--zoom ZOOM] [--file FILE] TILEJSON\n\nPositional arguments:\n  TILEJSON               input tilejson file\n\nOptions:\n  --output OUTPUT, -o OUTPUT\n                         output file or directory\n  --mbtiles              output mbtiles instead of files (automatically selected if output filename ends in '.mbtiles')\n  --dsn DSN, -d DSN      database connection string (dsn) for postgis\n  --init INIT            initialization SQL statement that is sent on connection/session start, for any specific optimizations\n  --workers WORKERS, -w WORKERS\n                         number of workers to spawn [default: 72]\n  --batch BATCH, -b BATCH\n                         size of the batch to query and write at once [default: 10]\n  --tileversion TILEVERSION\n                         version of the tileset (string) written to mbtiles metadata\n  --zoom ZOOM            comma-delimited set specific zooms to export (eg: 2,4,6,8)\n  --file FILE, -f FILE   a list of tiles to also generate, from a file where each line is a z/x/y tile coordinate\n  --help, -h             display this help and exit\n```\n\nTypical usage:\n```\nbaremaps-exporter -o ./tiles/ -d 'postgres://baremaps:baremaps@localhost:5432/baremaps' tiles.json\n```\n\n## Performance Tuning\n\nBy default, the exporter disables JIT since that often slows down large\nnumbers of queries required to export high volumes of tiles.\n\nAdditional SQL configuration commands may be useful for tuning. These commands\nare executed by the exporter at the start of a connection session and can be\nspecified with `--init`.\n\nA particularly useful one is: `SET enable_bitmapscan = off;`. It is common for\nthe planner to _think_ that there's a lot of features and prefer bitmap scans\nover going to the geospatial index first. This disables the planner from doing\nthat, so it first filters by the features in the geospatial region (tile\ncoordinates), and then filters the features within that geospatial region.\n\n## LICENSE\n\nThis work is licensed by [FlightAware](https://flightaware.com) under the [BSD 3-Clause License](./LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflightaware%2Fbaremaps-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflightaware%2Fbaremaps-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflightaware%2Fbaremaps-exporter/lists"}