# Editor degli orari di apertura

Le specifiche sugli orari di apertura di OpenStreetMap sono piuttosto articolate e non sono facilmente rappresentabili tramite un’interfaccia utente intuitiva.

Comunque sia il più delle volte solo una piccola parte della definizione viene realmente usata. L’editor considera questo aspetto omettendo gli elementi più oscuri dai menù e riducendo spesso e volentieri la libertà di azione dell’utente a piccole personalizzazioni di modelli predefiniti.

Questa documentazione è in continuo sviluppo

## Utilizzare l'editor degli orari di apertura

Nello scenario tipico, l’oggetto che stai modificando può sia avere già un’etichetta per gli orari di apertura (opening_hours, service_times e collection_times) oppure puoi riapplicare il valore predefinito all’oggetto per avere il campo degli orari di apertura vuoto. Se senti la necessità di inserire il valore manualmente e stai usando Vespucci, puoi modificare il campo nella pagina dettagli e poi tornare alla scheda per le modifiche. Se pensi che l’etichetta per gli orari di apertura debba far parte delle preimpostazioni, segnala il problema agli sviluppatori del tuo editor.

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).

Chiaramente puoi anche decidere di scrivere di tuo pugno un valore per gli orari di apertura, ma è consigliato partire da un modello preesistente.

Quando viene caricato un valore esistente per gli orari di apertura, il programma cerca di renderlo conforme alle specifiche degli orari di apertura. Qualora non fosse possibile, la posizione approssimativa dell’errore verrà evidenziata nella stringa grezza degli orari di apertura così che tu possa provare a correggerla manualmente. Circa un quarto dei valori degli orari di apertura nel database di OpenStreetMap hanno qualche problema, di questi meno del 10% può essere corretto, vedi OpeningHoursParser per ulteriori dettagli su quali deviazioni dalle specifiche sono tollerate.

### Bottone menù principale

- Aggiungi regola: aggiunge una nuova regola.
- Aggiungi regola per le festività: aggiunge una nuova regola per i giorni festivi insieme ad un cambiamento di stato.
- Aggiungi una regola per 24/7: aggiunge una regola per un oggetto che è sempre aperto, le specifiche degli orari di apertura non supportano valori secondari per 24/7 comunque noi permettiamo selezioni di periodi più grandi (per esempio periodi con una durata di anni).
- Carica modello: carica un modello esistente.
- Salva come modello: salva il valore attuale degli orari di apertura in un modello da usare in futuro.
- Gestisci modelli: modifica, per esempio cambia il nome, e cancella i modelli esistenti.
- Aggiorna: ricontrolla il valore degli orari di apertura.
- Elimina tutto: elimina tutte le regole.

### Regole

Le regole predefinite sono aggiunte come normali regole, ciò implica che esse sostituiscono i valori delle regole precedenti per gli stessi giorni. Questo potrebbe dare problemi quando si specifica orari estesi, in questi casi probabilmente dovrai impostare il tipo di regola nel menù Mostra tipo di regola su additivo.

#### Menù regole

- Aggiungi modificatore/commento: modifica l’effetto di questa regola e aggiungi un commento facoltativo.
- Aggiungi festività: aggiungi un selettore per festività pubbliche o scolastiche.
- Aggiungi intervallo di tempo
  - Orario - orario: un orario di inizio ed uno di fine nello stesso giorno.
  - Orario - orario esteso: da un orario di inizio fino ad un orario di fine del giorno seguente (ad esempio 26:00 che significa le 2 del mattino del giorno seguente).
  - Orario var. - orario: da un orario di inizio variabile (crepuscolo, alba, tramonto) ad uno di fine nello stesso giorno.
  - Orario var. - orario esteso: da un orario variabile di inizio ad uno di fine nel giorno seguente.
  - Orario - orario var.: da un orario di inizio ad uno di fine variabile.
  - Orario var. - orario var.: da un orario di inizio variabile ad uno di fine variabile.
  - Orario: un punto nel tempo.
  - Orario-senza un termine: da un orario di inizio in poi.
  - orario variabile: ad un orario non preciso
  - Orario variabile-senza un termine: da un orario di inizio variabile in poi
- Aggiungi intervallo di giorni: aggiungi un selettore di giorni della settimana.
- Aggiungi intervallo di date...
  - Data - data: da una data di inizio (anno, mese, giorno) fino ad una di fine.
  - Data variabile - data: da una data di inizio non precisa (per ora ciò significa Pasqua) fino ad una data di fine.
  - Data - data variabile: da una data di inizio ad una data non precisa.
  - Data variabile - data variabile: da una data non precisa ad un’altra.
  - Occorrenza nel mese - occorrenza nel mese: da un numero di giorno settimanale del mese ad un altro numero di giorno settimanale dello stesso mese.
  - Occorrenza nel mese - data: da un numero di giorno settimanale del mese ad una data di fine.
  - Data - occorrenza nel mese: da una data di inizio fino a un numero di giorno settimanale del mese.
  - Occorrenza nel mese - data variabile: da un numero di giorno settimanale del mese fino a una data non precisa.
  - Data variabile - occorrenza nel mese: da una data non precisa di inizio fino al numero di giorno settimanale nel mese.
  - Data - senza termine: da una data di inizio in poi.
  - Data variabile - senza un termine: da una data di inizio variabile in poi.
  - Occorrenza nel mese - senza un termine: dal numero di giorno della settimana di un mese in poi.
  - Con scostamenti...: le stesse voci come sopra solo con specificati degli scostamenti (raramente usato).
- Add year range...
  - Aggiungi intervallo annuale: aggiungi un selettore per gli anni.
  - Add starting year: add an open ended year range.
- Aggiungi intervallo di settimane: aggiungi un selettore per il numero della settimana.
- Duplica: crea una copia di questa regola e inseriscila dopo la posizione corrente.
- Mostra tipo di regola: visualizza e modifica il tipo di regola normale, additivo e di riserva (non disponibile per la prima regola).
- Sposta su: sposta questa regola di una posizione in alto (non disponibile per la prima regola).
- Sposta giù: sposta questa regola di una posizione in basso.
- Elimina: elimina questa regola.

### Intervalli di tempo

Per rendere la modifica degli intervalli di tempo più semplice possibile, quando vengono caricati valori già esistenti scegliamo un intervallo di tempo ed una granularità per le barre di intervallo che riteniamo ottimali. Per gli intervalli temporali nuovi le barre iniziano alle 6 del mattino e hanno incrementi di 15 minuti, questo può essere modificato attraverso il menù.

Cliccando sulla barra del tempo (non sui pin) si aprirà il selezionatore di tempo grande, più pratico quando usare direttamente le barre è troppo difficile. I selezionatori di tempo si estendono fino al giorno successivo, quindi sono un modo semplice per estendere un intervallo di tempo senza dover cancellare e riaggiungere l'intervallo.

#### Menù intervalli di tempo

- Display time picker: mostra un selezionatore di tempo grande per selezionare l'ora di inizio e di fine, su display molto piccoli questo è il modo preferito di cambiare i tempi.
- Passa a scatti di 15 minuti: utilizza una granularità di 15 minuti per la barra dell’intervallo.
- Passa a scatti di 5 minuti: utilizza una granularità di 5 minuti per la barra dell’intervallo.
- Passa a scatti di 1 minuto: utilizza una granularità di 1 minuto per la barra dell’intervallo.
- Inizia a mezzanotte: fa iniziare la barra dell’intervallo dalla mezzanotte.
- Mostra intervallo: visualizza il campo dell’intervallo per specificare un intervallo in minuti.
- Elimina: elimina questo intervallo di tempo.

### Gestisci modelli

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.