Migrazione da ZUERST a Ginto

Ottenere una chiave API

Per effettuare una migrazione senza interruzioni da ZUERST a Ginto, ti servono la chiave API e un filtro di pubblicazione.

‍

L'API è protetta e può essere richiamata solo se la richiesta viene autenticata tramite una chiave API. Contatta support@ginto.guide per ottenere tale chiave per l'autorizzazione API. Con essa potrai quindi recuperare tutti i dati dall'API di Ginto. La chiave API deve essere specificata in ogni richiesta come token Bearer nell'intestazione Authorization.

Affinché durante la query con Ginto tu riceva esattamente le stesse informazioni che ricevevi finora con la query ZUERST, il team di assistenza Ginto sarà lieto di creare per te un filtro di pubblicazione e di inviarti il relativo ID filtro. A tal fine, ti preghiamo di comunicarci con quale richiesta hai richiamato i dati finora.

In alternativa, l'API di Ginto ti offre diverse possibilità per filtrare direttamente i dati in base a diversi criteri al momento della richiesta. Trovi ulteriori informazioni al riguardo nella nostra documentazione API.

‍

Recuperare i dati

Utilizza la seguente query per recuperare i dati relativi alle voci della tua organizzazione. Sostituisci «filterId» con il numero che hai ricevuto dal team di assistenza Ginto nel primo passaggio.

{
    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
                    }
                }
            }
        }
    }
}

Personalizza il tuo codice

Modifica il tuo codice per estrarre i dati dalla nuova struttura della risposta. La tabella seguente mostra dove si trovavano in precedenza i dati nella risposta JSON di ZUERST e dove si trovano ora gli stessi dati nella risposta dell'API Ginto.

  
        ZUERST (Origine)
        Ginto
      
        Pois.[].Id
        data.entriesByFilter.nodes.[].zuerst.originIds
      
        Pois.[].IdSource
Utilizzato nella v1 della ZUERST API
        data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto, gli ID di origine sono sempre assegnati a una fonte specifica. Seleziona la fonte corretta e verifica se l'IdSource di ZUERST è contenuto negli originIds di Ginto.
      
        Pois.[].Sources.[].SourceName
Utilizzato nella v2 della ZUERST API
        data.entriesByFilter.nodes.[].sources.[].sourceKey
      
        Pois.[].Sources.[].SourcePoiId
Utilizzato nella v2 della ZUERST API
        data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto, una voce può rappresentare più POI di origine, sebbene originIds sia un array.
      
        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
Vedi il capitolo "Mappatura delle categorie"
      
        Pois.[].MainEnquiryCategory
        data.entriesByFilter.nodes.[].categories
Vedi il capitolo "Mappatura delle categorie"
      
        Pois.[].PictogramIds
        data.entriesByFilter.nodes.[].categories
Vedi Pois.[].accessibilityInfo.defaultRatings
      
        Pois.[].MainComment
        Non disponibile
      
        Pois.[].MainCommentFr
        Non disponibile
      
        Pois.[].MainCommentIt
        Non disponibile
      
        Pois.[].MainCommentEn
        Non disponibile
      
        Pois.[].LinkToDetailView
        data.entriesByFilter.nodes.[].publication.linkUrl
      
        Pois.[].AdditionalInformation
        Non disponibile
      
        Pois.[].SubPois
        Non disponibile

ZUERST (Origine)	Ginto
`Pois.[].Id`	`data.entriesByFilter.nodes.[].zuerst.originIds`
`Pois.[].IdSource` Utilizzato nella v1 della ZUERST API	`data.entriesByFilter.nodes.[].sources.[].originIds` In Ginto, gli ID di origine sono sempre assegnati a una fonte specifica. Seleziona la fonte corretta e verifica se l'`IdSource` di ZUERST è contenuto negli `originIds` di Ginto.
`Pois.[].Sources.[].SourceName` Utilizzato nella v2 della ZUERST API	`data.entriesByFilter.nodes.[].sources.[].sourceKey`
`Pois.[].Sources.[].SourcePoiId` Utilizzato nella v2 della ZUERST API	`data.entriesByFilter.nodes.[].sources.[].originIds` In Ginto, una voce può rappresentare più POI di origine, sebbene `originIds` sia un array.
`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` Vedi il capitolo "Mappatura delle categorie"
`Pois.[].MainEnquiryCategory`	`data.entriesByFilter.nodes.[].categories` Vedi il capitolo "Mappatura delle categorie"
`Pois.[].PictogramIds`	`data.entriesByFilter.nodes.[].categories` Vedi `Pois.[].accessibilityInfo.defaultRatings`
`Pois.[].MainComment`	Non disponibile
`Pois.[].MainCommentFr`	Non disponibile
`Pois.[].MainCommentIt`	Non disponibile
`Pois.[].MainCommentEn`	Non disponibile
`Pois.[].LinkToDetailView`	`data.entriesByFilter.nodes.[].publication.linkUrl`
`Pois.[].AdditionalInformation`	Non disponibile
`Pois.[].SubPois`	Non disponibile

Assegnare categorie

ZUERST e Ginto utilizzano categorie diverse. Il documento seguente illustra a quale categoria Ginto corrisponde ciascuna categoria ZUERST:

  
        ZUERST (Origine)
        Ginto
      
        Farmacia o drogheria
        drugstore
      
        Studio medico o dentistico
        doctors_practice
      
        Punto panoramico
        lookout
      
        Autonoleggio
        services_other
      
        Stazione ferroviaria
        train_station
      
        Banca
        bank
      
        Impianti di risalita / Ferrovie di montagna
        mountain_railway_station
      
        Biblioteca
        library
      
        Orto botanico
        park
      
        Campeggio
        camping
      
        Club / Discoteca
        club
      
        Centro commerciale
        mall
      
        Stadio del ghiaccio
        sports_facility
      
        Impianto Eurokey
        nil
      
        Casa o appartamento per vacanze
        holiday_home
      
        Aeroporto
        nil
      
        Bancomat (ATM)
        atm
      
        Negozi
        shopping_other
      
        Scuola (elementare, media, professionale o università)
        education_other
      
        Alloggi per gruppi
        group_house
      
        Hotel, pensione, Bed & Breakfast
        hotel
      
        Rifugio / Cabina
        group_house
      
        Assistenza all'infanzia / Asilo nido
        childcare
      
        Cinema
        cinema
      
        Sala congressi
        congress_center
      
        Sala da concerto, opera o teatro
        theatre
      
        Imbarcadero / Molo
        ship_landing
      
        Museo o galleria d'arte
        museum
      
        Servizi igienici pubblici
        public_toilets
      
        Ascensore pubblico o piattaforma elevatrice
        nil
      
        Parco o cimitero
        park
      
        Autosilo / Parcheggio multipiano
        multi_storey_car_park
      
        Parcheggio
        parking_lot
      
        Posta
        post
      
        Area di sosta (con parco giochi)
        playground
      
        Area di sosta (altro)
        park
      
        Punto di raccolta riciclaggio
        services_other
      
        Istituzione religiosa
        religious_institution
      
        Ristorante, caffè o bar
        restaurant
      
        Nave / Battello
        ship
      
        Scuola
        education_other
      
        Piscina, stabilimento balneare o lago
        swimming_pool
      
        Attrazione turistica
        sight
      
        Funivia
        mountain_railway_station
      
        Centro seminari
        congress_center
      
        Centro per anziani / Casa di cura
        nursing_home
      
        Centro sportivo o palestra
        sports_facility
      
        Stadio
        sports_facility
      
        Taxi
        services_other
      
        Ufficio del turismo
        tourist_information
      
        Fermata tram, bus o autopostale
        bus_stop
      
        Alloggio (altro)
        hotel
      
        Sala per eventi (altro)
        congress_center
      
        Associazione
        services_other
      
        Edificio amministrativo / Pubblica amministrazione
        administration
      
        Centro benessere / SPA
        sports_facility
      
        Zoo o parco faunistico
        park

Migrazione da ZUERST a Ginto

Ecco cosa troverai in questa guida:

Ottenere una chiave API

Recuperare i dati

Personalizza il tuo codice

Assegnare categorie

Richiedere la certificazione OK:GO per «Swisstainable»

Domande frequenti

Potrebbe interessarti anche questo

Login e primi passi

Trova luoghi accessibili

Partecipa a OK:GO

Modifica e aggiungi voci

L'API Ginto

Trova luoghi accessibili

Condividi informazioni

ZUERST (Origine)	Ginto
Farmacia o drogheria	`drugstore`
Studio medico o dentistico	`doctors_practice`
Punto panoramico	`lookout`
Autonoleggio	`services_other`
Stazione ferroviaria	`train_station`
Banca	`bank`
Impianti di risalita / Ferrovie di montagna	`mountain_railway_station`
Biblioteca	`library`
Orto botanico	`park`
Campeggio	`camping`
Club / Discoteca	`club`
Centro commerciale	`mall`
Stadio del ghiaccio	`sports_facility`
Impianto Eurokey	`nil`
Casa o appartamento per vacanze	`holiday_home`
Aeroporto	`nil`
Bancomat (ATM)	`atm`
Negozi	`shopping_other`
Scuola (elementare, media, professionale o università)	`education_other`
Alloggi per gruppi	`group_house`
Hotel, pensione, Bed & Breakfast	`hotel`
Rifugio / Cabina	`group_house`
Assistenza all'infanzia / Asilo nido	`childcare`
Cinema	`cinema`
Sala congressi	`congress_center`
Sala da concerto, opera o teatro	`theatre`
Imbarcadero / Molo	`ship_landing`
Museo o galleria d'arte	`museum`
Servizi igienici pubblici	`public_toilets`
Ascensore pubblico o piattaforma elevatrice	`nil`
Parco o cimitero	`park`
Autosilo / Parcheggio multipiano	`multi_storey_car_park`
Parcheggio	`parking_lot`
Posta	`post`
Area di sosta (con parco giochi)	`playground`
Area di sosta (altro)	`park`
Punto di raccolta riciclaggio	`services_other`
Istituzione religiosa	`religious_institution`
Ristorante, caffè o bar	`restaurant`
Nave / Battello	`ship`
Scuola	`education_other`
Piscina, stabilimento balneare o lago	`swimming_pool`
Attrazione turistica	`sight`
Funivia	`mountain_railway_station`
Centro seminari	`congress_center`
Centro per anziani / Casa di cura	`nursing_home`
Centro sportivo o palestra	`sports_facility`
Stadio	`sports_facility`
Taxi	`services_other`
Ufficio del turismo	`tourist_information`
Fermata tram, bus o autopostale	`bus_stop`
Alloggio (altro)	`hotel`
Sala per eventi (altro)	`congress_center`
Associazione	`services_other`
Edificio amministrativo / Pubblica amministrazione	`administration`
Centro benessere / SPA	`sports_facility`
Zoo o parco faunistico	`park`