# OpenStreetMapin aukioloaikamuokkain

OpenStreetMapin aukiloaikojen määrittely on melko monimutkainen eikä se suoralta kädeltä taivu yksinkertaiseksi ja intuitiiviseksi käyttöliittymäksi.

Toisaalta määrittelystä käytetään monesti vain pientä osaa. Muokkain ottaa tämän huomioon ja yrittää piilottaa oudoimmat piirteet valikoihin, jolloin tien päällä tarvitsee useimmiten tehdä vain pieniä muutoksia valmiisiin mallipohjiin.

Tämä dokumentaatio on alustava ja työn alla.

## Aukioloaikamuokkaimen käyttö

Tyypillisessä tapauksessa muokattavana olevalla kohteella joko on jo aukioloaikatägi (opening_hours, service_times ja collection_times) tai siihen voi soveltaa uudelleen esivalinnan, joka lisää tyhjän aukioloaikakentän. Jos sinun täytyy lisätä kenttä käsin Vespuccia käyttäessäsi, niin voit lisätä avaimen yksityikohtasivulta ja palata sitten takaisin muokkaamaan lomakepohjaiselle välilehdelle. Jos esivalinnassa kuuluisi mielestäsi olla aukioloaikatägi, voit lähettää muutospyynnön käyttämäsi muokkaimen kehittäjille.

If you have defined a default template (do this via the "Manage templates" menu item) it will be loaded automatically when the editor is started with an empty value. With the "Load template" function you can load any saved template and with the "Save template" menu you can save the current value as a template. You can define separate templates and defaults for specific key, for example "opening_hours", "collection_times" and "service_times" or custom values. Further you can limit applicability of a template to a region and a specific identifier, typically an OSM top-level tag (for example amenity=restaurant).

Voit luonnollisesti rakentaa aukioloajan (aoa) tyhjästä, mutta suosittelemme jonkin valmiin mallineen käyttämistä pohjana.

Kun muokkaimeen ladataan olemassa oleva arvo, se yritetään korjata automaattisesti aukioloaikamäärittelyn mukaiseksi. Jos tämä ei ole mahdollista, virheen summittainen paikka raa'assa aoa-arvossa korostetaan, ja voit yrittää korjata sen käsin. Suurinpiirtein neljänneksessä OpenStreetMapin tietokannan aoa-arvoista on ongelmia, ja alle kymmentä prosenttia ei voi korjata. Sivulla OpeningHourParser kerrotaan tarkemmin mitä poikkeamia määrittelystä sallitaan.

### Päävalikkonappi

- Lisää sääntö: lisää uusi sääntö.
- Lisää sääntö juhlapäiville: lisää uusi sääntö juhlapäiville ja sen tilamuutos.
- Lisää sääntö 24/7: lisää sääntö kohteelle, joka on aina auki; aukioloaikamäärittely ei tue alavalitsimien käyttämistä 24/7:n rinnalla, mutta tässä sallitaan korkeamman tason valitsimien lisääminen (esimerkiksi vuosijaksot).
- Lataa malline: lataa valmis malline.
- Tallenna mallineeksi: tallenna nykyinen aukioloaika-arvo mallineeksi tulevaa käyttöä varten.
- Mallipohjien hallinta: muokkaa (esim. vaihda nimi) ja poista mallipohjia.
- Päivitä: jäsennä aukioloaika-arvo uudelleen.
- Poista kaikki: poista kaikki säännöt.

### Säännöt

Oletussäännöt lisätään tavallisina sääntöinä, mikä tarkoittaa sitä, että ne syrjäyttävät aiemmat samoille päiville osuvat säännöt. Tällä voi olla merkitystä, kun määritetään laajennettuja aikoja – tyypillisesti tällöin on syytä muuttaa säännöt lisääviksi valikkokohdasta Näytä sääntötyyppi.

#### Sääntövalikko

- Lisää määre/kommentti: muuta säännön vaikutusalaa, ja lisää valinnainen kommentti.
- Lisää vapaapäivä: lisää valitsin yleiselle tai koulujen vapaapäivälle.
- Lisää aikaväli...
  - Aika–aika: alkuaika ja loppuaika samana päivänä.
  - Aika–laajennettu aika: alkuaika ja loppuaika eri päivinä (esim. 26:00 on 02:00 seuraavana päivänä).
  - Vaiht. aika–aika: vaihteleva alkuaika (aamu- tai iltahämärä, auringonnousu tai -lasku) ja loppuaika samana päivänä.
  - Vaiht. aika–laajennettu aika: vaihteleva alkuaika ja loppuaika peräkkäisinä päivinä.
  - Aika–vaiht. aika: alkuaika ja vaihteleva loppuaika.
  - Vaiht. aika–vaiht. aika: vaihteleva alkuaika ja vaihteleva loppuaika.
  - Aika: tietty ajankohta.
  - Aika–avoin loppu: tietystä ajankohdasta eteenpäin.
  - Vaihteleva aika: vaihtelevana ajankohtana.
  - Vaihteleva aika–avoin loppu: vaihtelevasta ajankohdasta eteenpäin.
- Lisää viikonpäiväjakso: lisää viikonpäiviin perustuva valitsin.
- Lisää päiväjakso...
  - Pvm–pvm: alku- ja loppupäivämäärä (vuosi, kk, päivä).
  - Vaihteleva pvm–pvm: vaihteleva alkupäivämäärä (määrittelyssä on toistaiseksi vain pääsiäinen) ja tietty loppupäivämäärä.
  - Pvm–vaihteleva pvm: alkupäivämäärä ja vaihteleva loppupäivämäärä.
  - Vaihteleva pvm–vaihteleva pvm: vaihteleva alku- ja loppupäivämäärä.
  - Esiintymiskerta kuussa–esiintymiskerta kuussa: alkaen viikonpäivän tietystä esiintymiskerrasta kuukauden aikana samaan esiintymäkertaan seuraavassa kuussa.
  - Esiintymiskerta kuussa–päivämäärä: alkaen viikonpäivän tietystä esiintymiskerrasta kuukauden aikana ja päättyen tiettyyn päivämäärään
  - Päivämäärä–esiintymiskerta kuussa: alkaen tietystä päivämäärästä ja päättyen viikonpäivän tiettyyn esiintymiskertaan kuukauden aikana.
  - Esiintymiskerta kuussa–vaihteleva päivämäärä: alkaen viikonpäivän tietystä esiintymiskerrasta kuukauden aikana ja päättyen vaihtelevaan päivämäärään.
  - Vaihteleva päivämäärä–esiintymiskerta kuussa: alkaen vaihtelevasta päivämäärästä ja päättyen viikonpäivän tiettyyn esiintymiskertaan kuukauden aikana.
  - Päivämäärä–avoin loppu: tietystä päivämäärästä eteenpäin.
  - Vaihteleva pvm–avoin loppu: vaihtelevasta päivämäärästä eteenpäin.
  - Esiintymiskerta kuussa–avoin loppu: viikonpäivän tietystä esiintymiskerrasta kuukauden aikana eteenpäin.
  - Poikkeama...: samat vaihtoehdot kuin edellä poikkeaman kanssa (harvoin käytetty).
- Add year range...
  - Lisää vuosijakso: lisää vuosiin perustuva valitsin.
  - Add starting year: add an open ended year range.
- Lisää viikkojakso: lisää viikkonumeroihin perustuva valitsin.
- Kahdenna: tee kopio tästä säännöstä välittömästi sen perään.
- Näytä sääntötyyppi: näytä säännön tyyppi ja/tai muuta sitä: tavallinen, lisäävä ja vara (ei ensimmäiselle säännölle).
- Siirrä ylöspäin: siirrä sääntö yhtä paikkaa ylemmäs (ei ensimmäiselle säännölle)
- Siirrä alaspäin: siirrä sääntö yhtä paikkaa alemmas.
- Poista: poista sääntö.

### Ajanjaksot

Jotta ajanjaksojen muokkaaminen olisi mahdollisimman helppoa, valmiita arvoja ladattaessa säätöasteikolle koetetaan antaa paras mahdollinen laajuus ja jaottelu. Uusien ajanjaksojen säätimissä alkuaika on 6:00, ja niissä on 15 minuutin jaotus. Asetuksia voi muuttaa valikon kautta.

Aikapalkin (ei jakomerkkien) klikkaaminen avaa ison aikavalitsimen, kun palkin käyttö suoraan on liian vaikeaa. Aikavalitsin ulottuu seuraavaan päivään, joten se on helppo tapa laajentaa aikaväliä tarvitsematta poistaa ja lisätä aikaväliä uudelleen.

#### Ajanjaksovalikko

- Näytä aikavalitsin: näytä iso valitsin, josta voi asettaa alku- ja loppuajan; pienille näytöille tämä on suositeltava tapa aikojen asettamiseen.
- 15 minuutin jaotus: käytä säätöpalkissa 15 minuutin tarkkuutta.
- 5 minuutin jaotus: käytä säätöpalkissa 5 minuutin tarkkuutta.
- 1 minuutin jaotus: käytä säätöpalkissa 1 minuutin tarkkuutta – todella vaikeaa puhelimessa.
- Aloita keskiyöstä: aseta säätöpalkin alkuaika keskiyöhön.
- Näytä aikaväli: näytä kenttä, johon asetetaan toistuva aikaväli minuutteina.
- Poista: poista ajanjakso.

### Hallitse mallineita

The template management dialog allows you to add, edit and delete templates.

In Android 4.4 and later the following additional functionality is available from the menu button.

- Show all: display all templates in the database.
- Save to file: write the contents of the template database to a file.
- Load from file (replace): load templates from a file replacing the current contents of the database.
- Load from file: load templates from a file retaining the current contents.

#### Save and edit template dialogs

The dialog allows you to set

- Name a descriptive name for the template.
- Default if checked this will be consider as a default template (typically further constrained by the other fields).
- Key the key this template is relevant for, if set to Custom key you can add a non-standard value in the field below. The key values support SQL wild cards, that is % matches zero or more characters, _ matches a single character. Both wild card characters can be escaped with \ for literal matches.
- Region the region the template is applicable to.
- Object an application specific string to use for matching.