https://github.com/opengeoshub/vdownload

A Powerful Geospatial Data Downloader
https://github.com/opengeoshub/vdownload

data geospatial opendata

Last synced: about 1 month ago
JSON representation

A Powerful Geospatial Data Downloader

• Host: GitHub
• URL: https://github.com/opengeoshub/vdownload
• Owner: opengeoshub
• License: mit
• Created: 2024-10-04T02:00:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-08T05:44:48.000Z (about 1 year ago)
• Last Synced: 2025-11-28T12:06:33.324Z (7 months ago)
• Topics: data, geospatial, opendata
• Language: Python
• Homepage:
• Size: 24.6 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# VDownload - A Powerful Geospatial Data Downloader

## Installation: 

[![PyPI version](https://badge.fury.io/py/vdownload.svg)](https://badge.fury.io/py/vdownload)

[![PyPI downloads](https://img.shields.io/pypi/dm/vdownload.svg)](https://pypistats.org/packages/vdownload)

![Downloads](https://static.pepy.tech/personalized-badge/vdownload?period=total&units=international_system&left_color=grey&right_color=blue&left_text=total)

- Using pip install: 

  ``` bash 

  pip install vdownload --upgrade

  ```

    

## Usage:

### OSM data:

#### Downnload OSM data by country/ region

  ``` bash 

  > osmdownload 

  ```

Ex: `> osmdownload vietnam` 

#### Show OSM info (.pbf)

  ``` bash 

  > osminfo 

  ```

Ex: `> osminfo vietnam.osm.pbf` 

#### Convert OSM daata to GeoJSON

  ``` bash 

  > osm2geojson -i  -o 

  ```

Ex: `> osm2geojson -i vietnam.osm.pbf -o vietnam.geojson` 

### Google Open Buildings:

#### Download Google Open Buildings by country:

  ``` bash 

  > openbuildings 

  ```

Ex: `> openbuildings vietnam` or `> openbuildings vnm`

### PMTIles:

#### Download PMTiles by country:

  ``` bash 

  > pmtiles extract  --country  ouput.pmtiles

  > pmtiles extract  --bbox= ouput.pmtiles

  ```

Ex: `> pmtiles extract  https://build.protomaps.com/20241027.pmtiles --country VNM vietnam.pmtiles` or `> openbuildings vnm`

  

#### Serve PMTiles:

  ``` bash 

  > ./pmtiles serve . --cors=\*

    # serves this directory at http://localhost:8080/TILESET/{z}/{x}/{y}.mvt 

    # the .pmtiles extension is added automatically

    # Access metadata at http://localhost:8080/TILESET/metadata

    #http://localhost:8080/TILESET/{z}/{x}/{y}.mvt 

    # S3 redirect: https://map-api-new.sovereignsolutions.net/sovereign/v20240410/vietnam_pmtiles/vietnam.pmtiles

    pmtiles serve . --bucket=https://example.com

    pmtiles serve / --bucket=s3://BUCKET_NAME

    pmtiles serve PREFIX --bucket=s3://BUCKET_NAME

  > 

  ```

Ex:   

  `> pmtiles serve .  --bucket=https://map-api-new.sovereignsolutions.net/sovereign/v20240410/vietnam_pmtiles`


  `> ./pmtiles serve . --cors=\* `