Algeria Cities

Android library that help with manipulating cities in algeria.

Download!

Add it in your root build.gradle at the end of repositories:

allprojects {
        repositories {
	        ...
		maven { url 'https://jitpack.io' }
	}
}

and then

implementation 'com.github.ikerfah:AlgeriaCities:0.2'

Functions

Name	Description
getWilayaById(int)	Get desired wilaya by identifier
getWilayaByName(String)	Get desired wilaya by name
getCommunesByWilayaId(int)	Get desired communes by wilaya identifier
getAllWilaya()	Get all wilaya

Example

AlgeriaCities.getWilayaById(44)

Widgets

Name	Description
WilayaSpinner	Spinner with predefined wilaya list
CommuneSpinner	Spinner with predefined commune for selected wilaya from WilayaSpinner Check attachCommuneSpinner

Example

<com.ikerfah.algeriacities.widgets.WilayaSpinner
        android:id="@+id/spinner"
        android:spinnerMode="dropdown"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:lang="arabic"/>

<com.ikerfah.algeriacities.widgets.CommuneSpinner
        android:id="@+id/spinner_child"
        android:layout_width="match_parent"
        android:spinnerMode="dropdown"
        android:layout_height="wrap_content"
        app:lang="french"/>

Tips and tricks

• Use wilayaSpinner.attachCommuneSpinner(CommuneSpinner) Then the communeSpinner will change automatically when the wilaya changed
• use setOnZoneItemSelectedListener for both Wilaya/Commune spinner and get selected wilaya/commune as first parameter along with other default parameters such as position

Example

spinner.setOnZoneItemSelectedListener(object: OnZoneItemSelected<Wilaya>{
            override fun onItemSelected(
                selectedZone: Wilaya?,
                parent: AdapterView<*>?,
                view: View?,
                position: Int,
                id: Long
            ) {
                Toast.makeText(parent?.context, selectedZone?.nomFr, Toast.LENGTH_SHORT).show()
            }

            override fun onNothingSelected(parent: AdapterView<*>?) {
            }

        })

XML Attributes (only with WilayaSpinner and CommuneSpinner)

Name	Description	Values
Lang	Default spinner language	french/arabic (Default french)

Example

app:lang="french" or app:lang="arabic"

Contacts

• If you have a concrete bug report for AlgeriaCites please go to the Issues Tracker, submit your report and tag it "bug".
• If you want to criticize the project, Feel free and contact me at : [email protected]