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)

  1. Call POST /api/geoconvert/convert/file with the input file and an optional outputFormat (multipart/form-data) — or POST /api/geoconvert/convert/batch to convert several files, each with its own outputFormats entry, in one request.
  2. Poll GET /api/geoconvert/convert/jobs/{jobId}/status for status.
  3. Download the output from downloadUrl while 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
PlanDownload link and output retention
Free4 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.


CADshift

Start typing to search the documentation

↑↓ to navigate Enter to select