Migration von ZUERST zu Ginto

API-Schlüssel erhalten

Für eine nahtlose Migration von ZUERST zu Ginto benötigst du zwei Informationen vom Ginto-Supportteam: 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 API-Schlüssel für die API-Autorisierung zu erhalten. Mit diesem kannst du anschliessend alle Daten von der Ginto-API beziehen. Der API-Key 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-Support-Team 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 wir dir im ersten Schritt zugesandt haben.

{
    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, wo sich die Daten zuvor in der ZUERST-JSON-Antwort befanden und wo sich dieselben Daten 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. Das folgende Dokument zeigt, welche ZUERST-Kategorie welcher Ginto-Kategorie entspricht:

  
      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

Zugängliche Lokalitäten finden

Die Ginto-API

Login und erste Schritte

Zugängliche Lokalitäten finden

Bei OK:GO mitmachen

Informationen teilen

Einträge bearbeiten und hinzufügen

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`