territories
======================================

+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| territories(name=None, level=None, territory_id=None, area=None, areaGreaterThan=None, areaSmallerThan=None, capital=None):                                                                          |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                                                                                                                      |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name            | str, optional   | Territory name by which the return will be fitered.                                                                                                              |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| level           | str, optional   | Territory name by which the return will be fitered.                                                                                                              |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| territory_id    | str, optional   | Territory ID by which the return will be fitered.                                                                                                                |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| area            | float, optional | Territorial area by which the return will be fitered.                                                                                                            |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| areaGreaterThan | float, optional | Territorial area restriction by which the return will be fitered. The function will return only territories with area strictly greater than the submitted value. |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| areaSmallerThan | float, optional | Territorial area restriction by which the return will be fitered. The function will return only territories with area strictly smaller than the submitted value. |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| capital         | bool, optional  | Return only capitals? True or False.                                                                                                                             |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| return          | pandasDataframe | Returns available Ipeadata territories.                                                                                                                          |
+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
`[source] <https://github.com/luanborelli/ipeadatapy/blob/master/ipeadatapy/territories.py>`__