Atlante della banda larga — Manuale destinato agli operatori di rete

Ufficio federale delle comunicazioni (UFCOM) — 2026
Contatto: atlas@bakom.admin.ch — www.atlaslargebande.ch

1. Introduzione

L'atlante della banda larga fornisce diverse informazioni sulla copertura della Svizzera con reti a banda ultralarga. È composto da mappe che forniscono informazioni sia sui collegamenti alle reti fisse sia sulla disponibilità delle reti di comunicazione mobile.

Le mappe relative alla rete fissa forniscono informazioni sulle velocità in upload e download, sui tipi di collegamento disponibili (rame, cavo coassiale, fibra ottica), nonché sui fornitori attivi nella zona osservata. Le informazioni sono pubblicate in forma aggregata per quadrati di 250 m x 250 m. Le reti di comunicazione mobile sono rappresentate da mappe che indicano, per ogni quadrato di 100 m x 100 m, la disponibilità prevista delle reti 2G, 3G, 4G e 5G.

L'obiettivo di questo manuale è fornire agli operatori una guida completa che consenta loro di garantire che i dati trasmessi siano esatti, esaustivi e conformi ai requisiti, in vista di una pubblicazione affidabile nell'Atlante.

2. Schema del processo per gli operatori

2.1 Svolgimento sintetico

Il processo completo per trasmettere i dati all'UFCOM comprende le seguenti fasi:

Annuncio di partecipazione presso l'UFCOM per la firma dell'accordo di cooperazione e l'attribuzione di uno o più NGA_PRID.
Ottenimento dei registri di riferimento per verificare gli edifici/indirizzi (RegBL o GeoPost).
Preparazione dei dati per entrata dell'edificio (EGID/EDID) o per ADR_GEOPOST_ID.
Generazione di un file XML o CSV conforme allo XSD (nga_upload.xsd).
Caricamento tramite l'applicazione web sicura; verifiche automatiche se XML.
Ricezione del rapporto di validazione, eventuali correzioni e nuovo caricamento.

Checklist di preparazione dei dati

1. Annuncio di partecipazione presso l'UFCOM

Firma dell'accordo di cooperazione e NGA_PRID attribuito/i atlas@bakom.admin.ch

Registrazione su www.uvek.egov.swiss effettuata.

2. Registri di riferimento

Ottenere i registri RegBL (www.housing-stat.ch) o GeoPost (www.post.ch)

L'utilizzo di questi registri è utile ma non indispensabile. Essi permettono di verificare che gli edifici (EGID/EDID) o gli indirizzi (ADR_GEOPOST_ID) esistano e siano di conseguenza considerati nelle analisi.

3. Struttura e valori dei dati

Le variabili richieste sono presenti nel file preparato

Velocità comprese tra 0–99999 o -1; tecnologie = yes/no; EGID/EDID o ADR_GEOPOST_ID conformi.

4. Validazione dei file

Generare XML → da validare localmente con nga_upload.xsd.

Se un CSV viene generato direttamente, assicurarsi che rispetti le regole definite nello XSD.

5. Creazione dello ZIP

Creare uno ZIP contenente l'XML o il CSV; denominazione secondo la convenzione (es. <company>_YYYYMMDD.zip)

6. Upload

Caricare tramite il servizio https://www.egov.swiss/; verificare il messaggio di sintassi → attendere il rapporto di validazione (verrà inviata un'e-mail).

2.2 Calendario e date di trasferimento

Il trasferimento dei dati avviene due volte all'anno: tra il 15 aprile e il 1° maggio, e tra il 15 ottobre e il 1° novembre. Successivamente, l'UFCOM elabora i dati e li pubblica rispettivamente il 2 giugno e il 2 dicembre.

Nota: la partecipazione è volontaria. Gli operatori che non desiderano partecipare non figurano nell'Atlante.

3. Annuncio di partecipazione presso l'UFCOM

Contatto iniziale: atlas@bakom.admin.ch. Questo annuncio costituisce una fase indispensabile per poter partecipare al progetto. La richiesta di partecipazione deve essere esaminata e approvata dal servizio competente. Al momento della registrazione, fornire:

Nome dell'impresa (pubblicato);
URL della pagina che presenta i servizi (pubblicato);
Coordinate della persona di contatto (non pubblicate);
Tipo/i di collegamento gestito/i (fibra, coassiale, rame);
Se del caso: contatti del terzo che trasmette i dati.

L'UFCOM fa firmare un accordo di cooperazione che definisce le modalità di utilizzo dei dati e assegna a ciascun operatore uno o più identificativi univoci (NGA_PRID).

I piccoli operatori possono, se lo desiderano, affidare la trasmissione dei dati a un intermediario, ad esempio Suissedigital.

4. Creazione di un account utente su www.uvek.egov.swiss

4.1 Registrazione come utente del portale

Per accedere all'area « Deposito dei dati per l'Atlante della banda larga », è necessario disporre di un login sul portale eGovernment DATEC. La registrazione avviene tramite il sistema centrale di autenticazione della Confederazione (eIAM) ed è gratuita.

La procedura completa di registrazione è descritta in Registrare il portale eGovernment.

4.2 Creazione o collegamento a un'organizzazione

Se la vostra organizzazione è già registrata, potete richiedere direttamente i diritti necessari tramite il servizio Richiedere i diritti organizzativi.

In caso contrario, dopo l'accesso, potete utilizzare il servizio « Creare un'organizzazione » per registrare i dati della vostra azienda o istituzione. Questo passaggio è richiesto solo se l'operatore è una persona giuridica. Ulteriori informazioni su questo processo sono disponibili in Creare un'organizzazione. Per una panoramica del processo di integrazione (onboarding), vedere la guida breve Guida breve – Onboarding utenti e organizzazioni.

4.3 Attivazione del servizio « Deposito dei dati per l'Atlante della banda larga »

Dal portale, aprire il Catalogo dei servizi, quindi navigare verso: Telecomunicazioni → « Deposito dei dati per l'Atlante della banda larga ». È quindi possibile avviare il servizio per depositare i propri dati, consultare i depositi precedenti o gestire i propri accessi.

Se la vostra organizzazione non era ancora registrata, nelle condizioni preliminari del servizio appare anche un link per la creazione dell'organizzazione.

4.4 Sicurezza e responsabilità

L'accesso utilizza il sistema di autenticazione federale eIAM. A seconda dei diritti assegnati, può essere richiesta un'autenticazione rafforzata (doppio fattore / OTP). Qualsiasi modifica della persona responsabile o qualsiasi cambiamento organizzativo deve essere comunicato immediatamente.

Nota: l'account deve essere personale e gli accessi non devono essere condivisi.

5. Ottenimento dei registri di riferimento

5.1 Registro federale degli edifici e delle abitazioni (RegBL — UST)

Download tramite www.housing-stat.ch. Il file minimo contiene per ogni entrata dell'edificio: EGID, EDID, identificativo del comune, indirizzo e NPA. Gli aggiornamenti utilizzati sono quelli di aprile e ottobre.

5.2 GeoPost Coordinate (La Posta)

Il registro dei dati degli indirizzi e dei geodati fornisce l'ADR_GEOPOST_ID, l'indirizzo completo e le coordinate geografiche (www.post.ch).

Attenzione: l'utilizzo di ADR_GEOPOST_ID può introdurre differenze locali rispetto al RegBL; alcuni ADR_GEOPOST_ID potrebbero non corrispondere a un EGID/EDID.

6. Preparazione dei dati

Gli operatori preparano il proprio set di dati per entrata dell'edificio (EGID+EDID) o per ADR_GEOPOST_ID, quindi generano un file XML o CSV conforme allo schema XSD fornito (allegato 1).

6.1 Attributi per entrata dell'edificio (RegBL) o indirizzi (Posta)

Per gli NGA_PRID di cui l'operatore è responsabile, fornire, per ogni EGID/EDID (o ADR_GEOPOST_ID), un set di dati comprendente:

Identificativi (esclusivi):
- Se i GWR_EGID e GWR_EDID sono noti:
  - GWR_EGID
  - GWR_EDID
  - ADR_GEOPOST_ID = -1
- Se gli ADR_GEOPOST_ID sono noti:
  - GWR_EGID = -1
  - GWR_EDID = -1
  - ADR_GEOPOST_ID
Velocità:
- BITRATE_DOWNSTREAM (Mbit/s)
- BITRATE_UPSTREAM (Mbit/s)
Tecnologie di rete disponibili (yes/no):
- AVAILABLE_NETWORK_TECHNOLOGY_COPPER
- AVAILABLE_NETWORK_TECHNOLOGY_COAX
- AVAILABLE_NETWORK_TECHNOLOGY_FIBRE
Qualità TV disponibile:
- BEST_AVAILABLE_TV_QUALITY (lasciare "none" — non pubblicato dal 2018)

6.2 Dati — definizioni

Campo	Tipo / valore	Descrizione
NGA_PRID	intero (1–9999)	Identificativo dell'operatore assegnato dall'UFCOM.
GWR_EGID	1–900000000 o -1	Identificativo federale dell'edificio (RegBL). Impostare -1 se viene utilizzato ADR_GEOPOST_ID.
GWR_EDID	-1 a 90	Identificativo dell'entrata dell'edificio. Impostare -1 se viene utilizzato ADR_GEOPOST_ID.
ADR_GEOPOST_ID	1–999999999 o -1	Identificativo GeoPost. Impostare -1 se vengono utilizzati GWR_EGID/GWR_EDID.
BITRATE_DOWNSTREAM	0–99999 o -1	Velocità massima in download in Mbit/s (−1 = non collegato).
BITRATE_UPSTREAM	0–99999 o -1	Velocità massima in upload in Mbit/s (−1 = non collegato).
BEST_AVAILABLE_TV_QUALITY	none / sdtv / hdtv	Compilare sistematicamente « none » (dato non pubblicato dal 2018).
AVAILABLE_NETWORK_TECHNOLOGY_COPPER	yes / no	Indicare se la tecnologia in rame è effettivamente disponibile all'entrata dell'edificio.
AVAILABLE_NETWORK_TECHNOLOGY_COAX	yes / no	Indicare se la tecnologia coassiale è effettivamente disponibile all'entrata dell'edificio.
AVAILABLE_NETWORK_TECHNOLOGY_FIBRE	yes / no	Indicare se la tecnologia in fibra ottica è effettivamente disponibile all'entrata dell'edificio.

6.4 Creazione e validazione XML

Lo schema XSD (allegato 1) definisce la struttura dei dati. Strumenti raccomandati:

script / database per grandi quantità (raccomandato).
Excel + mappatura XML (utile solo per piccoli set di dati);

Procedura Excel (riepilogo):

Scheda Sviluppatore → Origine → Mapping XML → aggiungere nga_upload.xsd.
Trascinare il nodo radice NGA_Root nel foglio → tabella di colonne.
Importare i dati XML esistenti o compilare la tabella.
Attivare la validazione rispetto allo schema, quindi Esportare → file XML.

Se l'esportazione segnala degli errori, consultare i « Dettagli » per correggerli.

7. Trasmissione dei dati

Il deposito dei file avviene tramite il portale eGovernment DATEC: https://www.uvek.egov.swiss/. Questo portale centralizzato sostituisce il precedente servizio NIS-DB e consente di gestire i propri file in modo sicuro.

Per depositare i propri file, seguire le istruzioni disponibili nel servizio « Deposito dei dati per l'Atlante della banda larga » del portale. Questo servizio guida passo dopo passo per:

Accedere e autenticarsi.
Caricare i file ZIP contenenti i propri dati XML o CSV.
Consultare, nel proprio spazio eGov, il rapporto di validazione generato a partire dai dati trasmessi; sarete avvisati via e-mail non appena questo rapporto sarà disponibile (termine di 1–2 giorni).

In caso di errori, correggere i propri dati e ricaricarli tramite il servizio.

8. Validazione dei dati trasmessi

Una volta caricati i dati nel database, essi vengono confrontati con i dati del periodo precedente (se esistono). A questo scopo, vengono creati diversi file. Ogni file corrisponde a un tipo preciso di verifica o di operazione. L'insieme di questi file viene quindi compresso e messo a disposizione degli utenti nel loro spazio Egov.

File riepilogativo globale — `summary_<période>.csv`

Per ogni NGA_PRID, questo file indica:

Lower_bitrate: edifici con velocità in download o upload ridotta.
Copper_change_but_not_to_fibre: Copper scomparso senza migrazione verso Fibre.
Copper_change_to_fibre: Copper sostituito da Fibre.
Coax_change_but_not_to_fibre: Coax scomparso senza migrazione verso Fibre.
Coax_change_to_fibre: Coax sostituito da Fibre.
Fibre_change: Fibre scomparsa.
New_buildings: nuovi edifici apparsi.
Removed_buildings: edifici scomparsi rispetto al periodo precedente.

Questo file fornisce una visione sintetica delle modifiche rilevate.

Altri file CSV

lower_bitrate_<période>.csv: dettagli degli edifici con velocità ridotta.
copper_changed_<période>.csv: edifici in cui Copper è cambiato (esclusa la migrazione verso Fibre).
coax_changed_<période>.csv: edifici in cui Coax è cambiato (esclusa la migrazione verso Fibre).
fibre_changed_<période>.csv: edifici in cui Fibre è cambiata.
new_buildings_<période>.csv: nuovi edifici.
removed_buildings_<période>.csv: edifici scomparsi.

Log di upload CSV

Ogni upload genera un file di log denominato: upload_YYYYMMDD_HHMMSS_<user>.log. Gli errori di caricamento sono visibili al suo interno.

Chiave di corrispondenza degli edifici

Confronto tra periodi tramite l'identificativo building_key:

Se gwr_egid e gwr_edid sono validi (≠ -1): building_key = gwr_egid || '-' || gwr_edid.
Altrimenti: building_key = adr_geopost_id.

Consigli per l'utilizzo

File denominati <utilisateur>_<type>_<période>.csv.
Il période segue il formato AAAAMM.
Consultare innanzitutto il summary, poi i file dettagliati se necessario.
Conservare questo README nella stessa cartella per la tracciabilità.

Allegati (estratti essenziali)

Allegato 1 — Schema XML completo (nga_upload.xsd)

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <!-- Root element NGA_Root -->
  <xs:element name="NGA_Root">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="Row" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

  <!-- Row element -->
  <xs:element name="Row">
    <xs:complexType>
      <xs:all>
        <xs:element ref="NGA_PRID"/>
        <xs:element ref="GWR_EGID"/>
        <xs:element ref="GWR_EDID"/>
        <xs:element ref="ADR_GEOPOST_ID"/>
        <xs:element ref="BITRATE_DOWNSTREAM"/>
        <xs:element ref="BITRATE_UPSTREAM"/>
        <xs:element ref="BEST_AVAILABLE_TV_QUALITY"/>
        <xs:element ref="AVAILABLE_NETWORK_TECHNOLOGY_COPPER"/>
        <xs:element ref="AVAILABLE_NETWORK_TECHNOLOGY_COAX"/>
        <xs:element ref="AVAILABLE_NETWORK_TECHNOLOGY_FIBRE"/>
      </xs:all>
    </xs:complexType>
  </xs:element>

  <!-- NGA_PRID -->
  <xs:element name="NGA_PRID">
    <xs:simpleType>
      <xs:restriction base="xs:short">
        <xs:minInclusive value="1"/>
        <xs:maxInclusive value="99999"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <!-- GWR_EGID -->
  <xs:element name="GWR_EGID">
    <xs:simpleType>
      <xs:union memberTypes="Available_GWR_EGID Int_Value_Not_Available"/>
    </xs:simpleType>
  </xs:element>

  <xs:simpleType name="Available_GWR_EGID">
    <xs:restriction base="xs:int">
      <xs:minInclusive value="1"/>
      <xs:maxInclusive value="900000000"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- GWR_EDID -->
  <xs:element name="GWR_EDID">
    <xs:simpleType>
      <xs:restriction base="xs:byte">
        <xs:minInclusive value="-1"/>
        <xs:maxInclusive value="90"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <!-- ADR_GEOPOST_ID -->
  <xs:element name="ADR_GEOPOST_ID">
    <xs:simpleType>
      <xs:union memberTypes="Available_Adr_Geopost_ID Int_Value_Not_Available"/>
    </xs:simpleType>
  </xs:element>

  <xs:simpleType name="Available_Adr_Geopost_ID">
    <xs:restriction base="xs:int">
      <xs:minInclusive value="1"/>
      <xs:maxInclusive value="999999999"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- Int_Value_Not_Available (-1) -->
  <xs:simpleType name="Int_Value_Not_Available">
    <xs:restriction base="xs:int">
      <xs:enumeration value="-1"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- BITRATE_DOWNSTREAM -->
  <xs:element name="BITRATE_DOWNSTREAM">
    <xs:simpleType>
      <xs:restriction base="xs:short">
        <xs:minInclusive value="-1"/>
        <xs:maxInclusive value="99999"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <!-- BITRATE_UPSTREAM -->
  <xs:element name="BITRATE_UPSTREAM">
    <xs:simpleType>
      <xs:restriction base="xs:short">
        <xs:minInclusive value="-1"/>
        <xs:maxInclusive value="99999"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <!-- BEST_AVAILABLE_TV_QUALITY -->
  <xs:element name="BEST_AVAILABLE_TV_QUALITY">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="none"/>
        <xs:enumeration value="hdtv"/>
        <xs:enumeration value="sdtv"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <!-- NETWORK TECHNOLOGIES -->
  <xs:element name="AVAILABLE_NETWORK_TECHNOLOGY_FIBRE">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="no"/>
        <xs:enumeration value="yes"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <xs:element name="AVAILABLE_NETWORK_TECHNOLOGY_COPPER">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="no"/>
        <xs:enumeration value="yes"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

  <xs:element name="AVAILABLE_NETWORK_TECHNOLOGY_COAX">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="no"/>
        <xs:enumeration value="yes"/>
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

</xs:schema>

Allegato 2 — Esempio XML

Scaricare l'esempio XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NGA_Root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="nga_upload.xsd">
  <Row>
    <NGA_PRID>155</NGA_PRID>
    <GWR_EGID>111222333</GWR_EGID>
    <GWR_EDID>0</GWR_EDID>
    <ADR_GEOPOST_ID>-1</ADR_GEOPOST_ID>
    <BITRATE_DOWNSTREAM>50</BITRATE_DOWNSTREAM>
    <BITRATE_UPSTREAM>5</BITRATE_UPSTREAM>
    <BEST_AVAILABLE_TV_QUALITY>sdtv</BEST_AVAILABLE_TV_QUALITY>
    <AVAILABLE_NETWORK_TECHNOLOGY_COPPER>no</AVAILABLE_NETWORK_TECHNOLOGY_COPPER>
    <AVAILABLE_NETWORK_TECHNOLOGY_COAX>no</AVAILABLE_NETWORK_TECHNOLOGY_COAX>
    <AVAILABLE_NETWORK_TECHNOLOGY_FIBRE>yes</AVAILABLE_NETWORK_TECHNOLOGY_FIBRE>
  </Row>
</NGA_Root>

Allegato 3 — Esempio CSV

Scaricare l'esempio CSV

NGA_PRID;GWR_EGID;GWR_EDID;ADR_GEOPOST_ID;BITRATE_DOWNSTREAM;BITRATE_UPSTREAM;AVAILABLE_NETWORK_TECHNOLOGY_COPPER;AVAILABLE_NETWORK_TECHNOLOGY_COAX;AVAILABLE_NETWORK_TECHNOLOGY_FIBRE;BEST_AVAILABLE_TV_QUALITY
155;111222333;0;-1;50;5;no;no;yes;none