Migration von ZUERST zu Ginto

Ultimo aggiornamento:
28/3/2026
API
app
Web
Prima di iniziare

Prima di iniziare

nota

FIRST rimane attivo con le sue interfacce per qualche tempo e poi si spegne gradualmente secondo la seguente pianificazione:

  • D'ora in poi: i sondaggi tramite FIRST rimangono disponibili tramite la FIRST API, ma sono anche completamente integrati in Ginto e sono accessibili tramite l'API Ginto.
  • 31.12.26: L'API FIRST viene messa in modalità standby e inoltra le richieste POI all'URL ginto corrispondente. Non vengono più effettuati sondaggi su FIRST.
  • 31.12.27: Chiusura completa di FIRST, API inclusa.

Per mantenere aggiornati i dati di accessibilità sulla tua piattaforma, devi ottenerli tramite l'API Ginto a partire dalla fine del 2026.

Consiglio professionale

Tieni presente che puoi definire un filtro insieme a noi per preselezionare i POI che riceverai tramite API.

Ecco cosa troverai in questa guida:

Richiedere il certificato OK:GO per la partecipazione a «Swisstainable»
Domande frequenti

Recupera le voci in modalità analogica PRIMA

  1. 1
    Fase 1
  2. 2
    Fase 2
  3. 3
    Fase 3
  4. 4
    Fase 4
  5. 5
    Fase 5

Esportazione di dati sul tuo sito web (vedi documentazione dettagliata allegata)

Puoi accedere ai tuoi dati tramite: https://zuerst.proinfirmis.ch/api/v1/tasks/exportpois?key=o9szp6HI&format=json

Il parametro «format» può essere modificato (xml, json o csv).

Nella prima parte dell'esportazione, vengono descritti i pittogrammi e vengono consegnati i file di immagine necessari.

Nella sezione «Punti di interesse», hai quindi accesso a una serie di informazioni per ciascuna località verificata. Queste informazioni in particolare sono utili per te:

IDSource: il tuo ID (corrisponde al campo «Source Id» dell'importazione)

LinkToDetailView: l'URL da integrare nelle tue pagine tramite un link a una visualizzazione dettagliata

PictogramId: i pittogrammi associati ai POI (i codici corrispondono al campo «Id» nell'area dei pittogrammi), che sono integrati nelle tue pagine.

mainCommentDE: un commento generale (opzionale). Può anche essere integrato nelle tue pagine.

Oltre ai tuoi dati, puoi accedere ai luoghi in cui il campo IDSource è vuoto. Tuttavia, non è necessario tenere un conto.

Integra i dati nei tuoi siti e piattaforme

Infine, i dati vengono integrati nel tuo sito web, con le seguenti informazioni per i POI:

- I pittogrammi associati

- Un link alla visualizzazione dettagliata dell'accessibilità (ad es. https://zuerst.proinfirmis.ch/pois/detail/25129)

Inoltre, un filtro o una funzionalità di ricerca basata sull'accessibilità sarebbe l'ideale, preferibilmente allo stesso livello delle normali funzionalità di filtro.

Lorem Ipsum e poi un frammento di codice

{
    allEntries(first: 50) {
        totalCount
        pageInfo {
            hasNextPage
            endCursor
        }
        edges {
            node {
                id
                name
            }
        }
    }
}

Ancora Lorem Ipsum e poi un altro frammento di codice

{
    allEntries(first: 50, after: "NTA") {
        totalCount
        pageInfo {
            hasNextPage
            endCursor
        }
        edges {
            node {
                id
                name
            }
        }
    }
}

Die API ist geschützt und kann nur aufgerufen werden, wenn die Anfrage mithilfe eines API-Schlüssels authentifiziert wird. Wende dich an support@ginto.guide, um einen API-Schlüssel für die API-Autorisierung zu erhalten. Mit diesem kannst du anschliessend alle Daten von der Ginto-API beziehen. Der API-Key muss bei jeder Anfrage als Bearer-Token im Authorization-Header angegeben werden.

Damit du bei der Abfrage mit Ginto exakt dieselben Informationen erhältst wie bisher bei der ZUERST-Abfrage, erstellt dir das Ginto-Support-Team gerne einen Veröffentlichungsfilter und sendet dir die entsprechende Filter-ID zu. Teile uns dazu bitte mit, mit welcher Anfrage du die Daten bisher abgerufen hast.

Alternativ bietet dir die Ginto-API verschiedene Möglichkeiten, die Daten bei der Abfrage direkt selbst nach verschiedenen Kriterien zu filtern. Weitere Informationen dazu findest du in unserer API-Dokumentation.

Daten abrufen

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
{
    entriesByFilter(filterId: "0ace704e-db54-41c1-aa45-8f5d1e45cc27") {
        totalCount
        pageInfo {
            endCursor
            hasNextPage
            hasPreviousPage
            startCursor
        }
        nodes {
            entryId
            name
            createdAt
            updatedAt
            categories {
                groupKey
                groupName
                key
                name
            }
            position {
                street
                housenumber
                postcode
                city
                countryCode
                lat
                lng
            }
            accessibilityInfo {
                defaultRatings {
                    descriptionDE: description(locale: DE)
                    descriptionEN: description(locale: EN)
                    descriptionFR: description(locale: FR)
                    descriptionIT: description(locale: IT)
                    iconUrl
                    key
                }
            }
            publication {
                linkTextDE: linkText(locale: DE)
                linkTextEN: linkText(locale: EN)
                linkTextFR: linkText(locale: FR)
                linkTextIT: linkText(locale: IT)
                linkUrl
            }
            licenseInfo {
                attribution
                isOpenData
                license
            }
            sources {
                originIds
                sourceKey
                sourceName
            }
            areas {
                areaTemplateKey
                id
                name
                accessibilityInfo {
                    defaultRatings {
                        descriptionDE: description(locale: DE)
                        descriptionEN: description(locale: EN)
                        descriptionFR: description(locale: FR)
                        descriptionIT: description(locale: IT)
                        iconUrl
                        key
                    }
                }
                publication {
                    linkTextDE: linkText(locale: DE)
                    linkTextEN: linkText(locale: EN)
                    linkTextFR: linkText(locale: FR)
                    linkTextIT: linkText(locale: IT)
                    linkUrl
                }
                subAreas {
                    areaTemplateKey
                    id
                    name
                    accessibilityInfo {
                        defaultRatings {
                            descriptionDE: description(locale: DE)
                            descriptionEN: description(locale: EN)
                            descriptionFR: description(locale: FR)
                            descriptionIT: description(locale: IT)
                            iconUrl
                            key
                        }
                    }
                    publication {
                        linkTextDE: linkText(locale: DE)
                        linkTextEN: linkText(locale: EN)
                        linkTextFR: linkText(locale: FR)
                        linkTextIT: linkText(locale: IT)
                        linkUrl
                    }
                }
            }
        }
    }
}

Deinen Code anpassen

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
ZUERST Ginto
Pois.[].Id data.entriesByFilter.nodes.[].zuerst.originIds
Pois.[].IdSource
Verwendet in v1 der ZUERST API
data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto werden die Quell-IDs stets einer bestimmten Quelle zugeordnet. Wähle die richtige Quelle aus und prüfe, ob die IdSource aus ZUERST in den originIds von Ginto enthalten ist.
Pois.[].Sources.[].SourceName
Verwendet in v2 der ZUERST API
data.entriesByFilter.nodes.[].sources.[].sourceKey
Pois.[].Sources.[].SourcePoiId
Verwendet in v2 der ZUERST API
data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto kann ein Eintrag mehrere Quell-POIs repräsentieren, obwohl originIds ein Array ist.
Pois.[].Name data.entriesByFilter.nodes.[].name
Pois.[].EntryDate data.entriesByFilter.nodes.[].updatedAt
Pois.[].Coordinates.Lat data.entriesByFilter.nodes.[].position.lat
Pois.[].Coordinates.Lng data.entriesByFilter.nodes.[].position.lng
Pois.[].Address.Street data.entriesByFilter.nodes.[].position.street
Pois.[].Address.Number data.entriesByFilter.nodes.[].position.housenumber
Pois.[].Address.ZipCode data.entriesByFilter.nodes.[].position.postcode
Pois.[].Address.City data.entriesByFilter.nodes.[].position.city
Pois.[].Category data.entriesByFilter.nodes.[].categories
Siehe Kapitel "Kategorien zuordnen"
Pois.[].MainEnquiryCategory data.entriesByFilter.nodes.[].categoriesSiehe Kapitel "Kategorien zuordnen"
Pois.[].PictogramIds data.entriesByFilter.nodes.[].categories
Siehe Pois.[].accessibilityInfo.defaultRatings
Pois.[].MainComment Nicht vorhanden
Pois.[].MainCommentFr Nicht vorhanden
Pois.[].MainCommentIt Nicht vorhanden
Pois.[].MainCommentEn Nicht vorhanden
Pois.[].LinkToDetailView data.entriesByFilter.nodes.[].publication.linkUrl
Pois.[].AdditionalInformation Nicht vorhanden
Pois.[].SubPois Nicht vorhanden

Kategorien zuordnen

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
ZUERST Ginto
Apotheke oder Drogerie drugstore
Arzt- oder Zahnarztpraxis doctors_practice
Aussichtspunkt lookout
Autoverleih services_other
Bahnhof train_station
Bank bank
Bergbahnen mountain_railway_station
Bibliothek library
Botanischer Garten park
Campingplatz camping
Club club
Einkaufszentrum mall
Eisstadion sports_facility
Eurokey-Anlage nil
Ferienhaus oder Ferienwohnung holiday_home
Flughafen nil
Geldautomat atm
Geschäfte shopping_other
Grund-, Mittel-, Berufs-, Fach- oder Hochschule education_other
Gruppenunterkünfte group_house
Hotel, Pension, Bed & Breakfast hotel
Hütte group_house
Kinderbetreuung childcare
Kino cinema
Kongresshalle congress_center
Konzerthalle, Oper oder Theatersaal theatre
Landesteg ship_landing
Museum oder Galerie museum
Öffentliche WC-Anlage public_toilets
Öffentlicher Aufzug oder Hebebühne nil
Park oder Friedhof park
Parkhaus multi_storey_car_park
Parkplatz parking_lot
Post post
Rastplatz (mit Spielplatz) playground
Rastplatz (sonst) park
Recycling- Sammelstelle services_other
Religiöse Einrichtung religious_institution
Restaurant, Café oder Bar restaurant
Schiff ship
Schule education_other
Schwimmbad, Strandbad oder See swimming_pool
Sehenswürdigkeit sight
Seilbahn mountain_railway_station
Seminarzentrum congress_center
Seniorenzentrum nursing_home
Sportzentrum oder Turnhalle sports_facility
Stadion sports_facility
Taxi services_other
Tourist Office tourist_information
Tram-, Bus- oder Postautostation bus_stop
Unterkunft (sonst) hotel
Veranstaltungsraum (sonst) congress_center
Verein services_other
Verwaltungsgebäude administration
Wellnesscenter sports_facility
Zoo oder Tierpark park

Richiedere la certificazione OK:GO per «Swisstainable»

OK:GO è riconosciuto come prova nell'ambito del programma di sostenibilità «Swisstainable» di Livello II - impegnato (in combinazione). Puoi trovare una panoramica di tutti i certificati di sostenibilità riconosciuti qui.

Un certificato di partecipazione OK:GO a «Swisstainable» può essere richiesto tramite questo modulo web. Un certificato viene rilasciato quando sono soddisfatte le condizioni di partecipazione. Il certificato OK:GO è valido per due anni dalla data di emissione.
Grazie, abbiamo ricevuto la tua richiesta e ti risponderemo nei prossimi giorni.
Oh, qualcosa non ha funzionato là fuori. Per favore riprova

Domande frequenti

Al momento non ci sono domande frequenti su questa guida.

Potrebbe interessarti anche questo