Metadata-Version: 2.1
Name: hvor
Version: 0.1.2
Summary: A library for assigning Norwegian metadata to coordinates
Home-page: https://github.com/bkkas/iout_foss
Keywords: pandas,dataframe,geopandas
Author: Espen Hafstad Solvang
Author-email: espenhafstadsolvang@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Rtree (>=0.9.7,<0.10.0)
Requires-Dist: geopandas (>=0.9.0,<0.10.0)
Requires-Dist: setuptools (>=57.4.0,<58.0.0)
Project-URL: Repository, https://github.com/bkkas/iout_foss
Description-Content-Type: text/markdown

# Hvor

Har du en eller flere koordinater innenfor Norges geografiske grenser som du
gjerne skulle visst mer om? `hvor` er et Python-bibliotek for å hente ut ulike
typer data for koordinater i Norge. Vi baserer oss på bruk av `pandas` og
`geopandas`. Data som kan hentes inkluderer:

- Kommunedata (kommune og kommunenummer)
- Fylkesdata (fylke og fylkesnummer)

Flere typer data vil bli lagt til etterhvert!

## Installering

Så enkelt som

```
pip install hvor
```

## Bruk

For et enkeltpunkt med latitude og longitude, bruk `point`

```python
>>> from hvor import point
>>> point(61.7327867684485, 5.540150406971685)
{'kommunenumer': [4602], 'kommune': ['Kinn'], 'fylkesnummer': [46], 'fylke': ['Vestland']}
```

For flere koordinater, igjen med latitude og longitude, bruk `points` (merk
**s** på slutten)

```python
>>> from hvor import points
>>> coordinates = {"lat": [63.414109, 69.14579124011655], "lon": [10.416230, 18.15361374220361]}
>>> points(coordinates)
{'kommunenummer': [5001, 5419], 'kommune': ['Trondheim', 'Sørreisa'], 'fylkesnummer': [50, 54], 'fylke': ['Trøndelag', 'Troms og Finnmark']}
```

Vipps, så har du kommune- og fylkesdata for koordinatene. (\*men kun hvis
nøklene dine for bredde- og lengdegrad dine het `lat` og `lon`😅).

## Credits

Tusen takk til

- [robhop](https://github.com/robhop) for deling av kommune- og fylkesdata.
- Kartverket for offentliggjøring av kartdata som robhop baserte seg på.

