Ultimo aggiornamento:
18/10/2026

Esempio di API

  • 1
  • 2
  • 3
  • 4
  • 5

Utilizza questa query per recuperare informazioni come i link web di Ginto e le valutazioni standard per specifiche località. Integrale insieme ad altri dati, come gli orari di apertura, sul tuo sito web. Qui trovi un esempio di applicazione.

Per ottenere un filtraggio efficiente, il team di supporto di Ginto può configurare per te un filtro di pubblicazione con diversi parametri (categoria, fonte, codice postale, stato di verifica, livello di dettaglio). Inserendo la filterId di questo filtro nella query, l'API restituirà solo le voci corrispondenti al filtro di pubblicazione.

‍

Variante senza sottosezioni

Con la seguente query puoi recuperare tutte le voci che corrispondono a un filtro di pubblicazione. Riceverai anche informazioni su nome, posizione, indirizzo, valutazioni standard e link web Ginto di ogni voce.

{
    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: contiene un elenco di tutte le valutazioni standard calcolate per la voce. Una valutazione standard include un pittogramma e una breve sintesi di un aspetto specifico dell'accessibilità della voce Ginto. Utilizza le valutazioni standard di una voce Ginto per pubblicare l'accessibilità di una località sul tuo sito web.

publication.linkUrl: contiene l'URL del link web Ginto della voce, dove sono disponibili tutte le informazioni dettagliate sull'accessibilità. Inserisci sempre questo link quando pubblichi l'accessibilità di località sul tuo sito web.

‍

Variante con sottosezioni

Se è necessario recuperare le valutazioni standard e il link web Ginto per ogni area all'interno di una voce, la query precedente può essere estesa come segue:

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

‍

‍

‍