geomaroc 1.0.1

A Python library to easily visualize geospatial data of Morocco.

Welcome to geomaroc

A Python library to make working with geospatial data of Morocco easier.

• GitHub repo: https://github.com/AmineAndam04/geomaroc
• PyPI: https://pypi.org/project/geomaroc/
• Raw data: https://github.com/AmineAndam04/geomaroc-Raw-data

Introduction

People who work in data science are seeing increased need to work with geospatial data, especially for visualization purposes (e.g. during the covid-19 pandemic).Geopandas is a very popular geospatial library in python that extends Pandas to allow spatial operations on geometrics types.

Working with geopands requires having access to coordinates of the items of our map (polygon coordinates), but having accesss to those coordinates is not an easy task.In fact, we often need the shapefiles in order to plot a map. Trying to find those shapefiles can be a long journey, especailly for someone with zero experience with geospatial data. Moreover, for someone interested in the geospatial data of Morocco, the majority of shapefiles available online are either of very poor quality, or they don't provide province-level,prefectue-level or district-level coordinates.Even if we manage to find the appropriate shapefiles, they usually come without the southern regions of Morocco.

Geomaroc helps the user get those coordinates easly.This library aims to fix these problem by:

 1. providing methods to automatically get the boundary coordinates to plot maps of Morocco **without having acces to shapefiles.**
  
 2. providing access to the coordinates of low-level administrative subdivisions (e.g. province, prefecture, districs).
  
 3. providing access to the complete map of  Morocco (including the southern regions of Morocco)

illustration:

Requirements

geomaroc library needs the following packages :pandas, geopandas, shapely, json and importlib.

Install

pip install BVCscrap
import BVCscrap as load

Usage

• getRegion() :Helps to plot the shape of each region.

import geomaroc
## working with n_region
gp=geomaroc.getRegion("Casablanca-Settat")
gp.plot()
## working with id_region
gp=geomaroc.getRegion(id_region=6) # Attention!! don't write geomaroc.getRegion(6)
gp.plot()

• getMultiRegion() :Helps to plot the shape of multiple regions.

import geomaroc
## working with n_region
gp=geomaroc.getMultiRegion(["Casablanca-Settat",Draa-Tafilalet])
gp.plot()
## working with id_region
gp=geomaroc.getMultiRegion(id_region=[6,8]) 
gp.plot()

• getProvince() :Helps to plot the shape of provinces within a region.

import geomaroc
## working with n_region
gp=geomaroc.getProvince("Casablanca-Settat")
gp.plot()
## working with id_region
gp=geomaroc.getProvince(id_region=6)
gp.plot()

• getMultiProvince(): Helps to plot the shape of provinces in multiple regions.

import geomaroc
## working with n_region
gp=geomaroc.getMultiProvince(["Casablanca-Settat",Draa-Tafilalet])
gp.plot()
## working with id_region
gp=geomaroc.getMultiProvince(id_region=[6,8])
gp.plot()

• getDistrict(): Helps to plot the shape of districts within a province.

import geomaroc
## working with n_province
geomaroc.getDistrict("Tetouan")
gp.plot()
## working with id_province
gp=geomaroc.getProvince(id_region=571)
gp.plot()

• getMultiDistrict(): Helps to plot the shape of districts in multiple provinces.

import geomaroc
## working with n_province
gp=geomaroc.gp=geomaroc.getMultiDistrict(["Tetouan","Tanger-Assilah","Al-Hoceima"])
gp.plot()
## working with id_province
gp=geomaroc.geomaroc.getProvince(id_region=[571,51,511])
gp.plot()

• Regions() & Provinces() : Hepls to respect the notation and to get the id of each region and province

Raw data

Visit geomaroc raw data

gallery