docs

Author: geohacker

README.md

@@ -213,6 +213,26 @@ The above command will generate a list of missing districts in the database base
 * `--import-missing missing-districts.txt` -- this will import districts for the iso2 mentioned in `missing-districts.txt` to the database. The file is the same format as generated by the default command.
 * `--import-all` -- this option is used to import all districts in the shapefile, if they don't have a code we can match against in the database.
 
+## import-admin2-data
+This management command is used for updating and importing admin2 shapefile. To run:
+* `python manage.py import-admin2-data <filename.shp>`
+
+The shapefile should have the following mandatory fields:
+* name or shapeName
+* code or pcode
+* admin1_id (this is the ID of the GO district this admin2 belongs to)
+
+See [this ticket](https://github.com/IFRCGo/go-api/issues/1492#issuecomment-1284120696) for a full workflow of preparing the admin2 shapefiles.
+The above command will generate a list of missing admin2s in the database based on the code (we use pcodes) to a file called `missing-admin2.txt`
+
+### Options available for the command
+* `--update-geom` -- updates the geometry for all admin2 matched in the shapefile.
+* `--update-bbox` -- updates the bbox for all admin2 matched in the shapefile.
+* `--update-centroid` -- updates the centroid for all admin2 matched in the shapefile.
+* `--import-missing missing-admin2.txt` -- this will import admin2 listed in `missing-districts.txt` to the database. The file is the same format as generated by the default command.
+* `--import-all` -- this option is used to import all admin2 in the shapefile.
+
+
 ## Update bbox for regions
 Run `python manage.py update-region-bbox` to update the bbox for each region in the database.