Migration de ZUERST vers Ginto

Obtenir une clé API

Pour migrer en toute transparence de ZUERST vers Ginto, vous avez besoin de la clé API et d'un filtre de publication.

L'API est sécurisée et ne peut être appelée que si la requête est authentifiée à l'aide d'une clé API. Veuillez contacter support@ginto.guide pour obtenir une clé d'autorisation API. Vous pourrez ensuite récupérer toutes les données depuis l'API Ginto. La clé API doit être transmise dans l'en-tête Authorization sous forme de jeton Bearer pour chaque requête.

Afin que vous obteniez exactement les mêmes informations avec Ginto qu'avec votre requête ZUERST, l'équipe de support Ginto se fera un plaisir de créer un filtre de publication et de vous envoyer l'ID de filtre correspondant. Veuillez nous indiquer la requête que vous utilisiez jusqu'à présent pour récupérer les données.

Alternativement, l'API Ginto vous offre diverses possibilités de filtrer vous-même les données directement lors de la requête selon différents critères. Vous trouverez plus d'informations à ce sujet dans notre documentation API.

API - Récupération de données

Utilisez la requête suivante pour récupérer les données des entrées de votre organisation. Remplacez « filterId » par le numéro que vous avez reçu de l'équipe de support Ginto lors de la première étape.

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

API - Adapter le code

Adaptez votre code pour extraire les données de la nouvelle structure de réponse. Le tableau ci-dessous indique l'emplacement précédent des données dans la réponse JSON ZUERST et leur nouvel emplacement dans la réponse de l'API Ginto.

  
        ZUERST (Source)
        Ginto
      
        Pois.[].Id
        data.entriesByFilter.nodes.[].zuerst.originIds
      
        Pois.[].IdSource
Utilisé dans la v1 de l'API ZUERST
        data.entriesByFilter.nodes.[].sources.[].originIds
Dans Ginto, les identifiants sources sont toujours attribués à une source spécifique. Sélectionnez la source appropriée et vérifiez si l'IdSource de ZUERST est inclus dans les originIds de Ginto.
      
        Pois.[].Sources.[].SourceName
Utilisé dans la v2 de l'API ZUERST
        data.entriesByFilter.nodes.[].sources.[].sourceKey
      
        Pois.[].Sources.[].SourcePoiId
Utilisé dans la v2 de l'API ZUERST
        data.entriesByFilter.nodes.[].sources.[].originIds
Dans Ginto, une entrée peut représenter plusieurs POI sources, bien que originIds soit un tableau (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
Voir le chapitre « Mappage des catégories »
      
        Pois.[].MainEnquiryCategory
        data.entriesByFilter.nodes.[].categories
Voir le chapitre « Mappage des catégories »
      
        Pois.[].PictogramIds
        data.entriesByFilter.nodes.[].categories
Voir Pois.[].accessibilityInfo.defaultRatings
      
        Pois.[].MainComment
        Non disponible
      
        Pois.[].MainCommentFr
        Non disponible
      
        Pois.[].MainCommentIt
        Non disponible
      
        Pois.[].MainCommentEn
        Non disponible
      
        Pois.[].LinkToDetailView
        data.entriesByFilter.nodes.[].publication.linkUrl
      
        Pois.[].AdditionalInformation
        Non disponible
      
        Pois.[].SubPois
        Non disponible

ZUERST (Source)	Ginto
`Pois.[].Id`	`data.entriesByFilter.nodes.[].zuerst.originIds`
`Pois.[].IdSource` Utilisé dans la v1 de l'API ZUERST	`data.entriesByFilter.nodes.[].sources.[].originIds` Dans Ginto, les identifiants sources sont toujours attribués à une source spécifique. Sélectionnez la source appropriée et vérifiez si l'`IdSource` de ZUERST est inclus dans les `originIds` de Ginto.
`Pois.[].Sources.[].SourceName` Utilisé dans la v2 de l'API ZUERST	`data.entriesByFilter.nodes.[].sources.[].sourceKey`
`Pois.[].Sources.[].SourcePoiId` Utilisé dans la v2 de l'API ZUERST	`data.entriesByFilter.nodes.[].sources.[].originIds` Dans Ginto, une entrée peut représenter plusieurs POI sources, bien que `originIds` soit un tableau (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` Voir le chapitre « Mappage des catégories »
`Pois.[].MainEnquiryCategory`	`data.entriesByFilter.nodes.[].categories` Voir le chapitre « Mappage des catégories »
`Pois.[].PictogramIds`	`data.entriesByFilter.nodes.[].categories` Voir `Pois.[].accessibilityInfo.defaultRatings`
`Pois.[].MainComment`	Non disponible
`Pois.[].MainCommentFr`	Non disponible
`Pois.[].MainCommentIt`	Non disponible
`Pois.[].MainCommentEn`	Non disponible
`Pois.[].LinkToDetailView`	`data.entriesByFilter.nodes.[].publication.linkUrl`
`Pois.[].AdditionalInformation`	Non disponible
`Pois.[].SubPois`	Non disponible

API - Attribution des catégories

ZUERST et Ginto utilisent des catégories différentes. L'aperçu suivant présente la correspondance entre les catégories ZUERST et celles de Ginto :

  
        ZUERST (Source)
        Ginto
      
        Pharmacie ou droguerie
        drugstore
      
        Cabinet médical ou dentaire
        doctors_practice
      
        Point de vue / Belvédère
        lookout
      
        Location de voitures
        services_other
      
        Gare ferroviaire
        train_station
      
        Banque
        bank
      
        Remontées mécaniques / Chemins de fer de montagne
        mountain_railway_station
      
        Bibliothèque
        library
      
        Jardin botanique
        park
      
        Terrain de camping
        camping
      
        Club / Discothèque
        club
      
        Centre commercial
        mall
      
        Patinoire
        sports_facility
      
        Installation Eurokey
        nil
      
        Maison ou appartement de vacances
        holiday_home
      
        Aéroport
        nil
      
        Distributeur automatique (Bancomat)
        atm
      
        Magasins / Commerces
        shopping_other
      
        École (primaire, secondaire, professionnelle ou université)
        education_other
      
        Hébergements de groupe
        group_house
      
        Hôtel, pension, Bed & Breakfast
        hotel
      
        Cabane / Refuge
        group_house
      
        Garderie d'enfants
        childcare
      
        Cinéma
        cinema
      
        Palais des congrès
        congress_center
      
        Salle de concert, opéra ou théâtre
        theatre
      
        Débarcadère / Ponton
        ship_landing
      
        Musée ou galerie
        museum
      
        Toilettes publiques
        public_toilets
      
        Ascenseur public ou plateforme élévatrice
        nil
      
        Parc ou cimetière
        park
      
        Parking couvert / Silo
        multi_storey_car_park
      
        Place de parc / Parking
        parking_lot
      
        Poste
        post
      
        Aire de repos (avec place de jeux)
        playground
      
        Aire de repos (autre)
        park
      
        Point de collecte de recyclage
        services_other
      
        Institution religieuse
        religious_institution
      
        Restaurant, café ou bar
        restaurant
      
        Bateau
        ship
      
        École
        education_other
      
        Piscine, plage ou lac
        swimming_pool
      
        Curiosité / Attraction touristique
        sight
      
        Téléphérique
        mountain_railway_station
      
        Centre de séminaires
        congress_center
      
        Centre pour seniors / EMS
        nursing_home
      
        Centre sportif ou salle de gym
        sports_facility
      
        Stade
        sports_facility
      
        Taxi
        services_other
      
        Office du tourisme
        tourist_information
      
        Arrêt de tram, bus ou car postal
        bus_stop
      
        Hébergement (autre)
        hotel
      
        Salle de réception / d'événement (autre)
        congress_center
      
        Association / Club
        services_other
      
        Bâtiment administratif
        administration
      
        Centre de bien-être / SPA
        sports_facility
      
        Zoo ou parc animalier
        park

Migration de ZUERST vers Ginto

C'est ce que vous trouverez dans ce guide :

Obtenir une clé API

API - Récupération de données

API - Adapter le code

API - Attribution des catégories

Demandez un preuve OK:GO pour «Swisstainable»

Questions fréquemment posées

Cela pourrait également vous intéresser

L'API Ginto

Partager des informations

ZUERST (Source)	Ginto
Pharmacie ou droguerie	`drugstore`
Cabinet médical ou dentaire	`doctors_practice`
Point de vue / Belvédère	`lookout`
Location de voitures	`services_other`
Gare ferroviaire	`train_station`
Banque	`bank`
Remontées mécaniques / Chemins de fer de montagne	`mountain_railway_station`
Bibliothèque	`library`
Jardin botanique	`park`
Terrain de camping	`camping`
Club / Discothèque	`club`
Centre commercial	`mall`
Patinoire	`sports_facility`
Installation Eurokey	`nil`
Maison ou appartement de vacances	`holiday_home`
Aéroport	`nil`
Distributeur automatique (Bancomat)	`atm`
Magasins / Commerces	`shopping_other`
École (primaire, secondaire, professionnelle ou université)	`education_other`
Hébergements de groupe	`group_house`
Hôtel, pension, Bed & Breakfast	`hotel`
Cabane / Refuge	`group_house`
Garderie d'enfants	`childcare`
Cinéma	`cinema`
Palais des congrès	`congress_center`
Salle de concert, opéra ou théâtre	`theatre`
Débarcadère / Ponton	`ship_landing`
Musée ou galerie	`museum`
Toilettes publiques	`public_toilets`
Ascenseur public ou plateforme élévatrice	`nil`
Parc ou cimetière	`park`
Parking couvert / Silo	`multi_storey_car_park`
Place de parc / Parking	`parking_lot`
Poste	`post`
Aire de repos (avec place de jeux)	`playground`
Aire de repos (autre)	`park`
Point de collecte de recyclage	`services_other`
Institution religieuse	`religious_institution`
Restaurant, café ou bar	`restaurant`
Bateau	`ship`
École	`education_other`
Piscine, plage ou lac	`swimming_pool`
Curiosité / Attraction touristique	`sight`
Téléphérique	`mountain_railway_station`
Centre de séminaires	`congress_center`
Centre pour seniors / EMS	`nursing_home`
Centre sportif ou salle de gym	`sports_facility`
Stade	`sports_facility`
Taxi	`services_other`
Office du tourisme	`tourist_information`
Arrêt de tram, bus ou car postal	`bus_stop`
Hébergement (autre)	`hotel`
Salle de réception / d'événement (autre)	`congress_center`
Association / Club	`services_other`
Bâtiment administratif	`administration`
Centre de bien-être / SPA	`sports_facility`
Zoo ou parc animalier	`park`