Dernière mise à jour : 
18/10/2026

Exemple d'API

  • 1
  • 2
  • 3
  • 4
  • 5

Utilisez cette requête pour récupérer des informations telles que les liens web Ginto et les évaluations standard pour des lieux spécifiques. Intégrez-les sur votre site web avec d'autres données, comme les heures d'ouverture. Vous trouverez ici un exemple d'application.

Pour un filtrage efficace, l'équipe de support Ginto peut configurer pour vous un filtre de publication avec divers paramètres (catégorie, source, code postal, statut de vérification, niveau de détail). En saisissant la filterId de ce filtre dans la requête, l'API ne renverra que les entrées correspondantes.

‍

Variante sans sous-zones

La requête suivante vous permet de récupérer toutes les entrées correspondant à un filtre de publication. Vous recevrez également des informations sur le nom, la position, l'adresse, les évaluations standard et le lien web Ginto de chaque entrée.

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

‍

‍accessibilityInfo.defaultRatings : Contient une liste de toutes les évaluations standard calculées pour l'entrée. Une évaluation standard comprend un pictogramme et un bref résumé d'un aspect spécifique de l'accessibilité. Utilisez ces évaluations pour publier l'accessibilité d'un lieu sur votre site.

publication.linkUrl : Contient l'URL du lien web Ginto de l'entrée, où figurent toutes les informations détaillées sur l'accessibilité. Intégrez toujours ce lien lorsque vous publiez des informations sur l'accessibilité de lieux sur votre site web.

‍

Variante avec sous-zones

Si vous devez récupérer les évaluations standard et le lien web Ginto pour chaque zone d'une entrée, la requête ci-dessus peut être étendue comme suit :

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

‍

‍