[{"data":1,"prerenderedAt":617},["ShallowReactive",2],{"guide:en:field-operations/imports":3},{"id":4,"title":5,"body":6,"description":609,"extension":610,"meta":611,"navigation":612,"path":613,"seo":614,"stem":615,"__hash__":616},"guide_en/en/user/field-operations/imports.md","GIS File Imports — Shapefile, GDB, GeoPackage, DXF, and More",{"type":7,"value":8,"toc":584},"minimark",[9,14,18,23,138,141,145,151,182,187,203,213,217,228,233,287,291,298,305,309,316,338,341,345,352,356,359,373,376,380,387,401,404,415,419,422,453,457,460,477,480,484,488,491,502,505,509,512,516,522,526,529,533],[10,11,13],"h1",{"id":12},"gis-file-imports","GIS File Imports",[15,16,17],"p",{},"Aptli can import a range of standard GIS and CAD file formats and convert them into map features. Imports run as background jobs so you can continue working while large files process. Imported features land in a staging area where you can filter by viewport, check for collisions with existing data, and select which features to commit to the map.",[19,20,22],"h2",{"id":21},"supported-formats","Supported Formats",[24,25,26,42],"table",{},[27,28,29],"thead",{},[30,31,32,36,39],"tr",{},[33,34,35],"th",{},"Extension",[33,37,38],{},"Format",[33,40,41],{},"Notes",[43,44,45,60,73,86,99,112,125],"tbody",{},[30,46,47,54,57],{},[48,49,50],"td",{},[51,52,53],"code",{},".zip",[48,55,56],{},"Zipped Shapefile (.shp + sidecar files)",[48,58,59],{},"Most common SHP delivery format",[30,61,62,67,70],{},[48,63,64],{},[51,65,66],{},".shp",[48,68,69],{},"Shapefile (bare)",[48,71,72],{},"Must include companion .dbf and .prj",[30,74,75,80,83],{},[48,76,77],{},[51,78,79],{},".gdb",[48,81,82],{},"ESRI File Geodatabase",[48,84,85],{},"Single layer extracted; complex GDBs may contain multiple layers",[30,87,88,93,96],{},[48,89,90],{},[51,91,92],{},".gpkg",[48,94,95],{},"OGC GeoPackage",[48,97,98],{},"SQLite-based, open standard",[30,100,101,106,109],{},[48,102,103],{},[51,104,105],{},".dxf",[48,107,108],{},"AutoCAD DXF",[48,110,111],{},"Geometry only; attributes limited",[30,113,114,119,122],{},[48,115,116],{},[51,117,118],{},".dgn",[48,120,121],{},"Bentley MicroStation DGN",[48,123,124],{},"v8 format supported",[30,126,127,132,135],{},[48,128,129],{},[51,130,131],{},".mdb",[48,133,134],{},"Microsoft Access / ESRI Personal Geodatabase",[48,136,137],{},"Requires server-side MDB support; contact your admin",[15,139,140],{},"All conversions are handled on the server. Files with multiple layers will have the first (or default) layer extracted.",[19,142,144],{"id":143},"starting-an-import","Starting an Import",[15,146,147],{},[148,149,150],"strong",{},"From the Data Transfer panel:",[152,153,154,162,169,176],"ol",{},[155,156,157,158,161],"li",{},"Open the map and click the ",[148,159,160],{},"Data Transfer"," button (↕ icon next to the version controls)",[155,163,164,165,168],{},"Switch to the ",[148,166,167],{},"Import"," tab",[155,170,171,172,175],{},"Click ",[148,173,174],{},"Choose File"," and select your GIS file",[155,177,171,178,181],{},[148,179,180],{},"Upload"," — the file is scanned for malware before processing begins",[15,183,184],{},[148,185,186],{},"From the Imports list page (Admin):",[152,188,189,195,200],{},[155,190,191,192],{},"Navigate to ",[148,193,194],{},"Admin → Imports",[155,196,171,197],{},[148,198,199],{},"New Import",[155,201,202],{},"Select file → Upload",[204,205,206],"blockquote",{},[15,207,208,209,212],{},"Importing requires the ",[51,210,211],{},"featureCreate"," admin right.",[19,214,216],{"id":215},"the-import-job","The Import Job",[15,218,219,220,223,224,227],{},"Uploads are asynchronous. As soon as the file passes the security scan, an ",[148,221,222],{},"import job"," is created and processing begins in the background. You receive a ",[148,225,226],{},"Job ID"," immediately and do not need to wait on the page.",[229,230,232],"h3",{"id":231},"job-statuses","Job Statuses",[24,234,235,245],{},[27,236,237],{},[30,238,239,242],{},[33,240,241],{},"Status",[33,243,244],{},"Meaning",[43,246,247,257,267,277],{},[30,248,249,254],{},[48,250,251],{},[51,252,253],{},"pending",[48,255,256],{},"Upload received; waiting for worker to start",[30,258,259,264],{},[48,260,261],{},[51,262,263],{},"processing",[48,265,266],{},"Server conversion running",[30,268,269,274],{},[48,270,271],{},[51,272,273],{},"completed",[48,275,276],{},"Features extracted; ready to review",[30,278,279,284],{},[48,280,281],{},[51,282,283],{},"failed",[48,285,286],{},"Conversion error — see error message for details",[229,288,290],{"id":289},"checking-status","Checking Status",[15,292,293,294,297],{},"Jobs appear in the ",[148,295,296],{},"Imports"," panel (Data Transfer → Import tab → Recent Imports). The list auto-refreshes. You can also navigate away and return later — jobs persist for 24 hours.",[15,299,300,301,304],{},"Clicking a completed job opens the ",[148,302,303],{},"Feature Preview"," with the extracted features plotted on the map.",[19,306,308],{"id":307},"feature-cap","Feature Cap",[15,310,311,312,315],{},"Imports are capped at ",[148,313,314],{},"5,000 features"," per file. If your file contains more:",[317,318,319,322,329,335],"ul",{},[155,320,321],{},"The first 5,000 features are imported",[155,323,324,325,328],{},"A ",[51,326,327],{},"truncated: true"," flag is set on the job",[155,330,331,332],{},"The total feature count is recorded in ",[51,333,334],{},"totalFeatures",[155,336,337],{},"A warning appears in the import panel",[15,339,340],{},"For files exceeding 5,000 features, split your source data into smaller chunks before uploading, or contact your admin to discuss batch processing options.",[19,342,344],{"id":343},"reviewing-imported-features","Reviewing Imported Features",[15,346,347,348,351],{},"Once a job completes, features are not yet permanently on the map — they land in the ",[148,349,350],{},"Draw staging area"," as draft features.",[229,353,355],{"id":354},"spatial-filtering","Spatial Filtering",[15,357,358],{},"Before committing, you can filter the preview by:",[317,360,361,367],{},[155,362,363,366],{},[148,364,365],{},"Bounding box"," — drag the map to the area of interest; the preview updates automatically",[155,368,369,372],{},[148,370,371],{},"Polygon filter"," — draw a custom polygon to select a sub-region of the import",[15,374,375],{},"This is useful when a large file covers more area than you need.",[229,377,379],{"id":378},"collision-detection","Collision Detection",[15,381,382,383,386],{},"Aptli checks incoming features against features already on the map. If an imported feature overlaps an existing feature at the same location with the same name, a ",[148,384,385],{},"collision warning"," appears:",[317,388,389,395],{},[155,390,391,394],{},[148,392,393],{},"Duplicate candidate"," — identical name + geometry within threshold distance",[155,396,397,400],{},[148,398,399],{},"Geometry conflict"," — overlapping polygons in the same layer",[15,402,403],{},"You can:",[317,405,406,409,412],{},[155,407,408],{},"Accept the import (create a new feature anyway)",[155,410,411],{},"Skip the conflicting feature",[155,413,414],{},"Merge into the existing feature",[229,416,418],{"id":417},"committing-to-the-map","Committing to the Map",[15,420,421],{},"After review:",[152,423,424,427,434,439,446],{},[155,425,426],{},"Select the features you want to keep (or \"Select All\")",[155,428,429,430,433],{},"Choose a ",[148,431,432],{},"target layer"," from the dropdown — imported features adopt that layer's schema",[155,435,171,436],{},[148,437,438],{},"Commit to Map",[155,440,441,442,445],{},"Features get the ",[51,443,444],{},"_uncommitted"," flag (visible in your draft, not yet on server)",[155,447,448,449,452],{},"Use the version controls (",[148,450,451],{},"Submit",") to push to the server when ready",[19,454,456],{"id":455},"geometry-type-splitting","Geometry Type Splitting",[15,458,459],{},"If your source file contains mixed geometry types (e.g., a GDB with both points and polygons), Aptli creates a separate draft import layer for each type:",[317,461,462,467,472],{},[155,463,464],{},[51,465,466],{},"_import_filename_point",[155,468,469],{},[51,470,471],{},"_import_filename_line",[155,473,474],{},[51,475,476],{},"_import_filename_polygon",[15,478,479],{},"Each can be committed to a different target layer independently.",[19,481,483],{"id":482},"troubleshooting","Troubleshooting",[229,485,487],{"id":486},"conversion-failed","\"Conversion failed\"",[15,489,490],{},"The server-side conversion failed. Common causes:",[317,492,493,496,499],{},[155,494,495],{},"Compressed file doesn't contain a valid shapefile (missing .dbf or .prj)",[155,497,498],{},"Corrupted file",[155,500,501],{},"GDB uses an unsupported ESRI format version",[15,503,504],{},"Check the error message on the failed job for specifics. Try opening the file in QGIS locally to verify it is readable.",[229,506,508],{"id":507},"file-failed-security-scan","\"File failed security scan\"",[15,510,511],{},"The file was quarantined by the security scanner. Do not re-upload the same file. If you believe it is a false positive, contact your admin.",[229,513,515],{"id":514},"unsupported-file-type","\"Unsupported file type\"",[15,517,518,519,521],{},"Only the extensions listed in the table above are accepted. Rename the file correctly (e.g., a SHP delivered in a ZIP must end in ",[51,520,53],{},").",[229,523,525],{"id":524},"import-disappears-after-24-hours","Import disappears after 24 hours",[15,527,528],{},"Import jobs expire after 24 hours. Completed jobs that are not committed to the map within that window are deleted. Commit your chosen features before the job expires.",[19,530,532],{"id":531},"permissions","Permissions",[24,534,535,545],{},[27,536,537],{},[30,538,539,542],{},[33,540,541],{},"Action",[33,543,544],{},"Required Right",[43,546,547,556,564,575],{},[30,548,549,552],{},[48,550,551],{},"Upload file",[48,553,554],{},[51,555,211],{},[30,557,558,561],{},[48,559,560],{},"View own import jobs",[48,562,563],{},"Authenticated",[30,565,566,569],{},[48,567,568],{},"View any user's job",[48,570,571,574],{},[51,572,573],{},"viewDeleted"," (admin)",[30,576,577,580],{},[48,578,579],{},"Commit imported features",[48,581,582],{},[51,583,211],{},{"title":585,"searchDepth":586,"depth":586,"links":587},"",2,[588,589,590,595,596,601,602,608],{"id":21,"depth":586,"text":22},{"id":143,"depth":586,"text":144},{"id":215,"depth":586,"text":216,"children":591},[592,594],{"id":231,"depth":593,"text":232},3,{"id":289,"depth":593,"text":290},{"id":307,"depth":586,"text":308},{"id":343,"depth":586,"text":344,"children":597},[598,599,600],{"id":354,"depth":593,"text":355},{"id":378,"depth":593,"text":379},{"id":417,"depth":593,"text":418},{"id":455,"depth":586,"text":456},{"id":482,"depth":586,"text":483,"children":603},[604,605,606,607],{"id":486,"depth":593,"text":487},{"id":507,"depth":593,"text":508},{"id":514,"depth":593,"text":515},{"id":524,"depth":593,"text":525},{"id":531,"depth":586,"text":532},"Import standard GIS and CAD files — Shapefiles, ESRI File Geodatabases, GeoPackages, DXF, and DGN — into the Aptli map as draft features ready to review, filter, and commit.","md",{},true,"/en/user/field-operations/imports",{"title":5,"description":609},"en/user/field-operations/imports","tMz4fd2eb5JomLkTM73gHgNgOTS4Hs9b3bwDWPfZY-I",1776295546621]