soutien
 > 
Migration de ZUERST vers Ginto

Migration de ZUERST vers Ginto

Dernière mise à jour : 
8/4/2026
API
appli
Web
La base de données sur l'accessibilité ZUERST de Pro Infirmis est entièrement intégrée à Ginto. Ainsi, toutes les données saisies par Pro Infirmis via ZUERST sont disponibles dans Ginto et peuvent être consultées directement sur cette plateforme.
Avant de commencer

L'API ZUERST de Pro Infirmis sera désactivée fin 2026. Il est donc nécessaire de migrer en temps utile vers l'API Ginto. L'API Ginto fournit les mêmes données que l'ancienne API ZUERST, mais dans une structure légèrement différente. Ginto propose en outre des informations supplémentaires sur l'accessibilité, par exemple concernant des hôtels ou des musées qui ont saisi eux-mêmes leurs informations dans le cadre de l'initiative OK:GO. Ce guide explique étape par étape la procédure de migration de ZUERST vers Ginto.

Note

Ginto combine des solutions logicielles de pointe et des données existantes sur une plateforme centrale. Derrière Ginto se trouve l'association Sitios. Elle a été fondée en 2022 par l'association Suisse sans obstacles, Pro Infirmis et l'association AccessibilityGuide. Son objectif est de coordonner et de développer davantage la gamme d'informations sur l'accessibilité en Suisse.

Conseil professionnel

ZUERST sera progressivement mis hors service selon le calendrier suivant :

  • Dès à présent : les informations relatives à l'accessibilité qui sont encore saisies par Pro Infirmis via ZUERST restent accessibles via l'API ZUERST, mais sont également entièrement intégrées à Ginto et peuvent être consultées directement via l'API Ginto. La plupart des saisies professionnelles effectuées par Pro Infirmis sont d'ores et déjà réalisées via Ginto.
  • 31 décembre 2026 : l'API ZUERST de Pro Infirmis sera mise en veille. Les requêtes POI seront redirigées vers l'URL Ginto correspondante. ZUERST ne permettra plus de saisir des informations relatives à l'accessibilité.
  • 31 décembre 2027 : arrêt complet de ZUERST, API comprise.

C'est ce que vous trouverez dans ce guide :

Obtenir une clé API
Récupérer les données
Personnaliser votre code
Attribuer des catégories
Demandez un preuve OK:GO pour «Swisstainable»
Questions fréquemment posées

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.

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

L'API est sécurisée et ne peut être interrogée que si la requête est authentifiée à l'aide d'une clé API. Veuillez contacter support@ginto.guide pour obtenir une telle clé permettant l'autorisation de l'API. Celle-ci vous permettra ensuite de récupérer toutes les données de l'API Ginto. La clé API doit être indiquée dans l'en-tête « Authorization » sous forme de jeton « Bearer » à chaque requête.

Afin que vous obteniez exactement les mêmes informations lors de la requête avec Ginto que celles obtenues jusqu'à présent avec la requête ZUERST, l'équipe d'assistance Ginto se fera un plaisir de créer un filtre de publication et de vous envoyer l'ID de filtre correspondant. Pour cela, veuillez nous indiquer avec quelle requête vous avez récupéré les données jusqu'à présent.

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

Récupérer les données

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

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

Personnaliser votre code

Modifie ton code pour extraire les données de la nouvelle structure de réponse. Le tableau suivant indique où se trouvaient auparavant les données dans la réponse JSON ZUERST et où elles se trouvent désormais dans la réponse de l'API Ginto.

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
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

Attribuer des catégories

ZUERST et Ginto utilisent des catégories différentes. Le document suivant indique à quelle catégorie Ginto correspond chaque catégorie ZUERST :

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
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

Demandez un preuve OK:GO pour «Swisstainable»

OK:GO est reconnu comme une preuve dans le cadre du programme de durabilité «Swisstainable» de niveau II - engaged (en combinaison). Vous trouverez un aperçu de tous les certificats de durabilité reconnus ici.

Un certificat OK:GO de participation à «Swisstainable» peut être demandé via ce formulaire en ligne. Un certificat est délivré lorsque les conditions de participation sont remplies. Le certificat OK:GO est valide pendant deux ans à compter de la date d'émission. Le certificat OK:GO est valable deux ans à compter de la date de délivrance.
Merci, nous avons bien reçu votre demande et nous vous répondrons dans les prochains jours.
Oh, quelque chose n'a pas marché là-bas. Veuillez réessayer

Questions fréquemment posées

Il n'existe actuellement aucune question fréquemment posée à propos de ce guide.

Cela pourrait également vous intéresser

Trouvez des lieux accessibles

L'API Ginto

Connexion et premiers pas

Trouvez des lieux accessibles

Rejoindre OK:GO

Partagez des informations

Modifier et ajouter des entrées