Migration von ZUERST zu Ginto

API-Schlüssel erhalten

Um nahtlos von ZUERST zu Ginto zu migrieren, benötigst du den API-Schlüssel und einen Veröffentlichungsfilter.

Die API ist geschützt und kann nur aufgerufen werden, wenn die Anfrage mithilfe eines API-Schlüssels authentifiziert wird. Wende dich an support@ginto.guide, um einen solchen Schlüssel für die API-Autorisierung zu erhalten. Mit diesem kannst du anschliessend alle Daten von der Ginto-API beziehen. Der API-Schlüssel muss bei jeder Anfrage als Bearer-Token im Authorization-Header angegeben werden.

Damit du bei der Abfrage mit Ginto exakt dieselben Informationen erhältst wie bisher bei der ZUERST-Abfrage, erstellt dir das Ginto-Supportteam gerne einen Veröffentlichungsfilter und sendet dir die entsprechende Filter-ID zu. Teile uns dazu bitte mit, mit welcher Anfrage du die Daten bisher abgerufen hast.

Alternativ bietet dir die Ginto-API verschiedene Möglichkeiten, die Daten bei der Abfrage direkt selbst nach verschiedenen Kriterien zu filtern. Weitere Informationen dazu findest du in unserer API-Dokumentation.

Daten abrufen

Verwende die folgende Abfrage, um die Daten für die Einträge deiner Organisation abzurufen. Ersetze dabei «filterId» durch die Nummer, die du im ersten Schritt vom Ginto-Supportteam erhalten hast.

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

Deinen Code anpassen

Passe deinen Code an, um die Daten aus der neuen Antwortstruktur auszulesen. Die folgende Tabelle zeigt, an welcher Stelle sich die Daten zuvor in der ZUERST-JSON-Antwort befanden und an welcher Stelle sie sich nun in der Antwort der Ginto-API befinden.

  
        ZUERST
        Ginto
      
        Pois.[].Id
        data.entriesByFilter.nodes.[].zuerst.originIds
      
        Pois.[].IdSource
Verwendet in v1 der ZUERST API
        data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto werden die Quell-IDs stets einer bestimmten Quelle zugeordnet. Wähle die richtige Quelle aus und prüfe, ob die IdSource aus ZUERST in den originIds von Ginto enthalten ist.
      
        Pois.[].Sources.[].SourceName
Verwendet in v2 der ZUERST API
        data.entriesByFilter.nodes.[].sources.[].sourceKey
      
        Pois.[].Sources.[].SourcePoiId
Verwendet in v2 der ZUERST API
        data.entriesByFilter.nodes.[].sources.[].originIds
In Ginto kann ein Eintrag mehrere Quell-POIs repräsentieren, obwohl originIds ein Array ist.
      
        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
Siehe Kapitel "Kategorien zuordnen"
      
        Pois.[].MainEnquiryCategory
        data.entriesByFilter.nodes.[].categoriesSiehe Kapitel "Kategorien zuordnen"
      
        Pois.[].PictogramIds
        data.entriesByFilter.nodes.[].categories
Siehe Pois.[].accessibilityInfo.defaultRatings
      
        Pois.[].MainComment
        Nicht vorhanden
      
        Pois.[].MainCommentFr
        Nicht vorhanden
      
        Pois.[].MainCommentIt
        Nicht vorhanden
      
        Pois.[].MainCommentEn
        Nicht vorhanden
      
        Pois.[].LinkToDetailView
        data.entriesByFilter.nodes.[].publication.linkUrl
      
        Pois.[].AdditionalInformation
        Nicht vorhanden
      
        Pois.[].SubPois
        Nicht vorhanden

ZUERST	Ginto
`Pois.[].Id`	`data.entriesByFilter.nodes.[].zuerst.originIds`
`Pois.[].IdSource` Verwendet in v1 der ZUERST API	`data.entriesByFilter.nodes.[].sources.[].originIds` In Ginto werden die Quell-IDs stets einer bestimmten Quelle zugeordnet. Wähle die richtige Quelle aus und prüfe, ob die `IdSource` aus ZUERST in den `originIds` von Ginto enthalten ist.
`Pois.[].Sources.[].SourceName` Verwendet in v2 der ZUERST API	`data.entriesByFilter.nodes.[].sources.[].sourceKey`
`Pois.[].Sources.[].SourcePoiId` Verwendet in v2 der ZUERST API	`data.entriesByFilter.nodes.[].sources.[].originIds` In Ginto kann ein Eintrag mehrere Quell-POIs repräsentieren, obwohl `originIds` ein Array ist.
`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` Siehe Kapitel "Kategorien zuordnen"
`Pois.[].MainEnquiryCategory`	`data.entriesByFilter.nodes.[].categories`Siehe Kapitel "Kategorien zuordnen"
`Pois.[].PictogramIds`	`data.entriesByFilter.nodes.[].categories` Siehe `Pois.[].accessibilityInfo.defaultRatings`
`Pois.[].MainComment`	Nicht vorhanden
`Pois.[].MainCommentFr`	Nicht vorhanden
`Pois.[].MainCommentIt`	Nicht vorhanden
`Pois.[].MainCommentEn`	Nicht vorhanden
`Pois.[].LinkToDetailView`	`data.entriesByFilter.nodes.[].publication.linkUrl`
`Pois.[].AdditionalInformation`	Nicht vorhanden
`Pois.[].SubPois`	Nicht vorhanden

Kategorien zuordnen

ZUERST und Ginto verwenden unterschiedliche Kategorien. Die folgende Übersicht zeigt die Zuordnung der ZUERST- zu den Ginto-Kategorien.:

  
        ZUERST
        Ginto
      
        Apotheke oder Drogerie
        drugstore
      
        Arzt- oder Zahnarztpraxis
        doctors_practice
      
        Aussichtspunkt
        lookout
      
        Autoverleih
        services_other
      
        Bahnhof
        train_station
      
        Bank
        bank
      
        Bergbahnen
        mountain_railway_station
      
        Bibliothek
        library
      
        Botanischer Garten
        park
      
        Campingplatz
        camping
      
        Club
        club
      
        Einkaufszentrum
        mall
      
        Eisstadion
        sports_facility
      
        Eurokey-Anlage
        nil
      
        Ferienhaus oder Ferienwohnung
        holiday_home
      
        Flughafen
        nil
      
        Geldautomat
        atm
      
        Geschäfte
        shopping_other
      
        Grund-, Mittel-, Berufs-, Fach- oder Hochschule
        education_other
      
        Gruppenunterkünfte
        group_house
      
        Hotel, Pension, Bed & Breakfast
        hotel
      
        Hütte
        group_house
      
        Kinderbetreuung
        childcare
      
        Kino
        cinema
      
        Kongresshalle
        congress_center
      
        Konzerthalle, Oper oder Theatersaal
        theatre
      
        Landesteg
        ship_landing
      
        Museum oder Galerie
        museum
      
        Öffentliche WC-Anlage
        public_toilets
      
        Öffentlicher Aufzug oder Hebebühne
        nil
      
        Park oder Friedhof
        park
      
        Parkhaus
        multi_storey_car_park
      
        Parkplatz
        parking_lot
      
        Post
        post
      
        Rastplatz (mit Spielplatz)
        playground
      
        Rastplatz (sonst)
        park
      
        Recycling- Sammelstelle
        services_other
      
        Religiöse Einrichtung
        religious_institution
      
        Restaurant, Café oder Bar
        restaurant
      
        Schiff
        ship
      
        Schule
        education_other
      
        Schwimmbad, Strandbad oder See
        swimming_pool
      
        Sehenswürdigkeit
        sight
      
        Seilbahn
        mountain_railway_station
      
        Seminarzentrum
        congress_center
      
        Seniorenzentrum
        nursing_home
      
        Sportzentrum oder Turnhalle
        sports_facility
      
        Stadion
        sports_facility
      
        Taxi
        services_other
      
        Tourist Office
        tourist_information
      
        Tram-, Bus- oder Postautostation
        bus_stop
      
        Unterkunft (sonst)
        hotel
      
        Veranstaltungsraum (sonst)
        congress_center
      
        Verein
        services_other
      
        Verwaltungsgebäude
        administration
      
        Wellnesscenter
        sports_facility
      
        Zoo oder Tierpark
        park

Migration von ZUERST zu Ginto

Das findest du in dieser Anleitung:

API-Schlüssel erhalten

Daten abrufen

Deinen Code anpassen

Kategorien zuordnen

OK:GO-Nachweis für «Swisstainable» beantragen

Häufig gestellte Fragen

Das könnte dich auch interessieren

Die Ginto-API

Informationen teilen

ZUERST	Ginto
Apotheke oder Drogerie	`drugstore`
Arzt- oder Zahnarztpraxis	`doctors_practice`
Aussichtspunkt	`lookout`
Autoverleih	`services_other`
Bahnhof	`train_station`
Bank	`bank`
Bergbahnen	`mountain_railway_station`
Bibliothek	`library`
Botanischer Garten	`park`
Campingplatz	`camping`
Club	`club`
Einkaufszentrum	`mall`
Eisstadion	`sports_facility`
Eurokey-Anlage	`nil`
Ferienhaus oder Ferienwohnung	`holiday_home`
Flughafen	`nil`
Geldautomat	`atm`
Geschäfte	`shopping_other`
Grund-, Mittel-, Berufs-, Fach- oder Hochschule	`education_other`
Gruppenunterkünfte	`group_house`
Hotel, Pension, Bed & Breakfast	`hotel`
Hütte	`group_house`
Kinderbetreuung	`childcare`
Kino	`cinema`
Kongresshalle	`congress_center`
Konzerthalle, Oper oder Theatersaal	`theatre`
Landesteg	`ship_landing`
Museum oder Galerie	`museum`
Öffentliche WC-Anlage	`public_toilets`
Öffentlicher Aufzug oder Hebebühne	`nil`
Park oder Friedhof	`park`
Parkhaus	`multi_storey_car_park`
Parkplatz	`parking_lot`
Post	`post`
Rastplatz (mit Spielplatz)	`playground`
Rastplatz (sonst)	`park`
Recycling- Sammelstelle	`services_other`
Religiöse Einrichtung	`religious_institution`
Restaurant, Café oder Bar	`restaurant`
Schiff	`ship`
Schule	`education_other`
Schwimmbad, Strandbad oder See	`swimming_pool`
Sehenswürdigkeit	`sight`
Seilbahn	`mountain_railway_station`
Seminarzentrum	`congress_center`
Seniorenzentrum	`nursing_home`
Sportzentrum oder Turnhalle	`sports_facility`
Stadion	`sports_facility`
Taxi	`services_other`
Tourist Office	`tourist_information`
Tram-, Bus- oder Postautostation	`bus_stop`
Unterkunft (sonst)	`hotel`
Veranstaltungsraum (sonst)	`congress_center`
Verein	`services_other`
Verwaltungsgebäude	`administration`
Wellnesscenter	`sports_facility`
Zoo oder Tierpark	`park`