Metadata-Version: 2.1
Name: latviastreetify
Version: 0.2.0
Summary: module that help get streets and neiborhoods from latitude longitude
Author-email: William Droz <william.droz@idiap.ch>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: geopandas >= 0.13.2,<1.0.0
Requires-Dist: pyproj >=3.6.0,<4
Requires-Dist: typer[all] >= 0.9.0,<1.0.0 ; extra == "cli"
Requires-Dist: black == 22.3.0 ; extra == "dev"
Requires-Dist: coverage >= 6.4.2,<7.0.0 ; extra == "dev"
Requires-Dist: flake8 >=3.8.3,<4.0.0 ; extra == "dev"
Requires-Dist: mypy >=0.971,<1.0 ; extra == "dev"
Requires-Dist: pre-commit >=3.3.3,<4.0.0 ; extra == "dev"
Requires-Dist: pytest >=7.1.2,<8.0.0 ; extra == "dev"
Project-URL: Home, https://gitlab.idiap.ch/socialcomputing/Icarus/latvian_streets_neighborhoods
Provides-Extra: cli
Provides-Extra: dev

# latvian_streets_neighborhoods

## install

`pip install latviastreetify`

or with CLI capabilities

`pip install latviastreetify[cli]`

### Using external files

You can use external files for address and neighbordhoods by setting the enviroment variables to external `.shp` files.

```bash
# for streets/address
export STREETS_FILE=
# for neighbordhoods
export NEIGHBORHOODS_FILE=
```

## Usage examples

### Head of the dataframe

```python
from latviastreetify.resolvers import Language, SteetsAndNeighborhoodsResolver
from pprint import pprint

resolver = SteetsAndNeighborhoodsResolver()
gdf = resolver.get_gdf(language=Language.EN)
pprint(gdf.head())
```

```
        Address     Street Number  Rotation                   Geometry        lat        lon  index_right     Name                       Website
1  pūku iela 14  pūku iela     14     110.0  POINT (24.25629 56.87265)  56.872648  24.256293          3.0  dārziņi  https://apkaimes.lv/darzini/
2  pūku iela 12  pūku iela     12     110.0  POINT (24.25618 56.87248)  56.872484  24.256180          3.0  dārziņi  https://apkaimes.lv/darzini/
3  pūku iela 10  pūku iela     10     110.0  POINT (24.25602 56.87228)  56.872280  24.256022          3.0  dārziņi  https://apkaimes.lv/darzini/
4   pūku iela 2  pūku iela      2     110.0  POINT (24.25694 56.87278)  56.872777  24.256936          3.0  dārziņi  https://apkaimes.lv/darzini/
5   pūku iela 4  pūku iela      4     110.0  POINT (24.25680 56.87260)  56.872602  24.256800          3.0  dārziņi  https://apkaimes.lv/darzini/
```

## CLI Usage

**Usage**:

```console
$ [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--install-completion`: Install completion for the current shell.
* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
* `--help`: Show this message and exit.

**Commands**:

* `search-by-address`
* `search-by-code`
* `search-by-name`
* `search-by-number`
* `search-by-street`
* `search-multiple`

## `search-by-address`

**Usage**:

```console
$ search-by-address [OPTIONS] SEARCH_VALUE
```

**Arguments**:

* `SEARCH_VALUE`: [required]

**Options**:

* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

## `search-by-code`

**Usage**:

```console
$ search-by-code [OPTIONS] SEARCH_VALUE
```

**Arguments**:

* `SEARCH_VALUE`: [required]

**Options**:

* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

## `search-by-name`

**Usage**:

```console
$ search-by-name [OPTIONS] SEARCH_VALUE
```

**Arguments**:

* `SEARCH_VALUE`: [required]

**Options**:

* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

## `search-by-number`

**Usage**:

```console
$ search-by-number [OPTIONS] SEARCH_VALUE
```

**Arguments**:

* `SEARCH_VALUE`: [required]

**Options**:

* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

## `search-by-street`

**Usage**:

```console
$ search-by-street [OPTIONS] SEARCH_VALUE
```

**Arguments**:

* `SEARCH_VALUE`: [required]

**Options**:

* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

## `search-multiple`

**Usage**:

```console
$ search-multiple [OPTIONS]
```

**Options**:

* `--address TEXT`
* `--name TEXT`
* `--street TEXT`
* `--number TEXT`
* `--code TEXT`
* `--language [EN|LAV]`: [default: Language.EN]
* `--help`: Show this message and exit.

