Steder-API

Stedspreposisjoner til folket!


Introduksjon

Velkommen til Steder-API!

Lurer du på om det heter i Oslo eller på Oslo, eller i Lillehammer eller på Lillehammer. Eller kanskje det ble litt mye på deg i går og du lurer litt på hvor du er akkurat nå?

For med Steder-api kan du finne ut en masse informasjon om steder i Norge. Og også ca. hvor folk er, uten å bruke GPS. Du får preposisjoner til de fleste steder, altså om det heter i eller på, koordinater, hvor mange som bor der, hvilket fylke det er i, når sola står opp, hvordan været er og mye annet.

  • API navn: Steder-API
  • API version : v 1.0
  • Lisens: Gratis for alle
  • Av: Peder Jørgensen

Kom i gang

Det er superenkelt å bruke Steder-API.

Det enkleste kallet du kan gjøre er dette:

https://steder-api.no/api

Som gir deg navnet på stedet du er akkurat nå samt en del informasjon om stedet.

                                

Du kan også søke etter steder ved å bruke query parameteret "q"

https://steder-api.no/api?q=karmøy
{
  "place": "Karmøy", 
  "municipality": "Karmøy", 
  "county": "Rogaland", 
  "preposition": "på", 
  "preposition_probability": 0.9196141479099679, 
  "population": 8599, 
  "area_size_km2": 5.31, 
  "position": {
    "lon": 5.3071112, 
    "lat": 59.2801018
  }
}

Du kan hente mer informasjon om stedet ved å bruke følgende query parameter:

Få tider for sol opp og ned ved å bruke: include_sun_times = 1

Få været på stedet akkurat nå ved å bruke: include_weather = 1

OBS! Å inkludere ekstra parametre for sol og vær gjør et kall til meteorologisk institutt sitt API, dette gjør at kallet tar litt lenger tid enn om du ikke har det med.

https://steder-api.no/api?q=vadsø&include_sun_times=1&include_weather=1
                                    
                                    
                                

Hvorfor i all verden har du laget dette APIet?

Jeg skulle egentlig lage en nettside som ga informasjon om når flagget skal opp og ned, men endte med å lage dette APIet.

Jeg tar forbehold om at det kan være feil i informasjonen du får fra APIet. Om du finner noen feil eller bare har lyst å kontakte meg, så gjør det gjerne på mailen min.

peder.jorgensen (at) gmail.com

Besøk nettsiden min om du vil se andre prosjekter jeg jobber på.