Skip to main content

🗂️ Shapefile (SHP) Writer

The Shapefile writer exports your results as an ESRI Shapefile package. Because a Shapefile consists of multiple component files, Geoflip returns it as a single .zip archive for easy download and sharing.

📜 Format Details​

  • Delivery: Always a .zip archive.
  • Contents of the zip:
    • .shp — geometry
    • .shx — shape index
    • .dbf — attributes
    • .prj — projection information (reflects output.epsg)
  • MIME type: application/zip
  • CRS handling: Output CRS is defined by output.epsg in your request.

⚙️ Example Config​

{
  "input": { "format": "geojson" },
  "transformations": [
    { "type": "buffer", "params": { "distance": 100, "units": "meters" } }
  ],
  "output": {
    "format": "shp",
    "epsg": 4326
  }
}

📑 Example API Call​

curl -X POST https://api.geoflip.io/transform \
  -F 'config={
    "input":{"format":"geojson"},
    "transformations":[{"type":"buffer","params":{"distance":100,"units":"meters"}}],
    "output":{"format":"shp","epsg":4326}
  }' \
  -F "input_file=@/path/to/aoi.geojson;type=application/geo+json"

Response

{ "job_id": "abcd-ef01-2345-6789" }

Poll status:

curl https://api.geoflip.io/result/status/abcd-ef01-2345-6789

When status is SUCCESS, download from the output_url:

curl -O https://api.geoflip.io/result/output/abcd-ef01-2345-6789

This downloads a .zip containing the .shp, .shx, .dbf, and .prj files.

✅ Notes​

  • The .prj file in the archive is generated from your output.epsg.
  • Attributes from your input are preserved in the .dbf table where applicable.
  • Works with any supported reader input (geojson, shp, dxf) and transformation pipeline.

➡️ Next Steps​