GeoConvert Overview
GeoConvert is a cloud service that converts between GeoJSON, Shapefile, and about 17 other vector GIS formats (GeoPackage, KML, GPX, XLSX, GeoParquet, and more) for GIS workflows.
What GeoConvert Does
- Converts GeoJSON or Shapefile input to any supported target format, with configurable target EPSG
- Converts multiple files in a single batch request, with the output format selectable per file
- Runs a pre-flight data-loss report before a lossy GeoJSON→Shapefile conversion
- Tracks conversions as jobs with status and downloadable output
- Supports web UI usage and API automation
Ways to Use GeoConvert
Web UI
Use the GeoConvert page in the CADshift web app to upload files, run conversions, and download results.
API
Automate conversions through the GeoConvert API. See the GeoConvert API Reference for the full endpoint list, request and response details.
All API calls require the X-API-Key header.
API keys are available on every plan, including the free tier; free-tier API calls use the same free conversions as the web UI. Create keys on the GeoConvert subscriptions page. In an organization only an org admin creates keys, and members use the admin’s keys.
Typical Conversion Flow
API (X-API-Key)
- Call
POST /api/geoconvert/convert/filewith the input file and an optionaloutputFormat(multipart/form-data) — orPOST /api/geoconvert/convert/batchto convert several files, each with its ownoutputFormatsentry, in one request. - Poll
GET /api/geoconvert/convert/jobs/{jobId}/statusfor status. - Download the output from
downloadUrlwhile it is valid.
Limits and Retention
- Max file size: 50 MB per file
- Batch requests: up to 20 files per request, 200 MB total
- Download links and stored outputs last as long as the plan’s retention below, counted from the conversion; after that the link stops working and the output is deleted
| Plan | Download link and output retention |
|---|---|
| Free | 4 hours |
| Pay as you go (personal wallet) | 2 days |
| Organization (organization wallet) | 2 days |
If you lose the response that carried a job’s downloadUrl, list your recent jobs with GET /api/geoconvert/convert/jobs; every completed job whose link is still valid comes back with a fresh URL.
Pricing and Wallet
GeoConvert uses pay-as-you-go pricing based on input file size. Add funds to your wallet and spend only when conversions run. Wallet balances do not expire. In a batch request, each file is charged independently, so one file’s failure or an exhausted balance does not affect the others. A conversion is charged only once its output is stored; if the charge cannot be applied (for example the wallet was emptied by another request in the meantime) the job fails and nothing is delivered.
Use GET /api/geoconvert/pricing/tiers to show the current size tiers in your UI before running a job.
Storage Regions
Pay-as-you-go users choose the storage region for their outputs on the GeoConvert dashboard; free-tier conversions use the site default. An organization has one storage region for all of its members, and only organization admins can change it.
Organization Access
An organization’s GeoConvert access is managed by its admins: they enable GeoConvert for the organization, top up the organization wallet, create the API keys members use, and can restrict access to one Azure AD group. Once GeoConvert is enabled, members’ conversions are charged to the organization wallet.
Related Docs
- Next
- API Reference