Skip to main content

🗂️ Shapefile Reader

The Shapefile (SHP) reader allows you to upload ESRI Shapefiles into Geoflip. Shapefiles are a widely used GIS format consisting of multiple component files. To work with Geoflip, these must be packaged into a single .zip archive.

📜 Format Details​

  • File type: .zip archive containing the required Shapefile components.
  • Required files inside the archive:
    • .shp — geometry
    • .shx — shape index
    • .dbf — attributes
    • .prj — projection information (CRS)
  • Upload type: Always send the .zip archive as input_file in a multipart form.
  • CRS handling:
    • Geoflip reads the CRS from the .prj file.
    • If .prj is missing or invalid, reprojection may fail.

⚙️ Example Config​

{
  "input": {
    "format": "shp"
  },
  "transformations": [
    { "type": "union" }
  ],
  "output": {
    "format": "dxf",
    "epsg": 3857
  }
}

📑 Example API Call​

First, zip the Shapefile components:

zip /tmp/parcels.zip parcels.shp parcels.shx parcels.dbf parcels.prj

Then send to the API:

curl -X POST https://api.geoflip.io/transform \
  -F 'config={
    "input":{"format":"shp"},
    "transformations":[{"type":"union"}],
    "output":{"format":"dxf","epsg":3857}
  }' \
  -F "input_file=@/tmp/parcels.zip;type=application/zip"

Response

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

Poll for status:

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

And download from the output_url when status is SUCCESS.

✅ Notes​

  • All four components (.shp, .shx, .dbf, .prj) are required for stable results.
  • For large datasets, compression in .zip helps reduce upload size.
  • CRS reprojection is applied at the output stage, based on output.epsg.
  • Shapefiles are ideal when working with legacy GIS workflows or ESRI ecosystem data.

➡️ Next Steps​