Skip to content

Find connected objects

With the discover.swiss knowledge graph objects will be connected to enrich data. On this page, the currently available options are described how to retrieve connected data.

Important

The queries are only possible with the knowledge graph features. Please check the availability of this feature on the Knowledge graph page

Find recommendations

Objects can have reviews which contain recommended POIs for example for a Tour several Restaurants or Places can be recommended to visit during the tour. More details can be found on the reviews and recommendations page.

OK:GO provides accessibility conditions for places. The accessibility information needs to be retrieved from ginto by the links which are stored in the links array.

For example you can search a specifc POI with the source-id:

body

{
    "project": "<partnerProject>",
    "sourceId": "1168",
    "facets": [ ],
    "select": "identifier,type,name,link",
    "currentPage": 1,
    "resultsPerPage": 100
}

The response contains the links array with the needed Ginto Links. The GintoWeb Link is the rendered HTML page and with the GintoResource link, the accessibility information will be returned as JSON.

{
    "count": 1,
    "values": [
        {
            "identifier": "log_px9-s28_bbgi",
            "name": "Engimatt City & Garden Hotel",
            "link": [
                {
                    "url": "https://www.ginto.guide/entries/1dd54a4a-6bab-448d-90a2-1dc5fe82e2cd",
                    "title": "Show accessibility information",
                    "type": "GintoWeb"
                },
                {
                    "url": "https://api.ginto.guide/entries/1dd54a4a-6bab-448d-90a2-1dc5fe82e2cd",
                    "type": "GintoResource"
                }
            ]
        }
    ]
}

Find objects by location

You could search Events and Products by location ID (place identifier). As a result, all objects from specified place will be found.

Events search example:

body

{
    "project": "<partnerProject>",
    "location": "civ_px9-s28_bggg",
    "combinedTypeTree": "Thing|Event",
    "facets": [],
    "currentPage": 1,
    "resultsPerPage": 2
}

The Response shows the available Events at the civ_px9-s28_bggg (National Museum Zurich) because they are connected to this place.

{
    "count": 58,
    "values": [
        {
            "@id": "http://localhost:7071/api/events/eve_wt1_iggbeffei",
            "identifier": "eve_wt1_iggbeffei",
            "datasource": [
                "gdl"
            ],
            "dataGovernance": {
                "origin": [
                    {
                        "datasource": "gdl",
                        "sourceId": "866145548",
                        "created": "2022-08-22T23:18:00+00:00",
                        "lastModified": "2022-08-22T23:18:00+00:00",
                        "license": "C-All-Rights-Reserved",
                        "provider": {
                            "acronym": "gdl",
                            "name": "Guidle",
                            "logo": {
                                "contentUrl": "https://img1.oastatic.com/img2/54940951/max/guidle.png"
                            },
                            "link": [
                                {
                                    "url": "https://www.guidle.com/",
                                    "type": "WebHomepage"
                                }
                            ],
                            "identifier": "gdl"
                        },
                        "source": {
                            "name": "Landesmuseum Zürich"
                        }
                    }
                ]
            },
            "type": "Event",
            "additionalType": "HistoryEvent",
            "address": {
                "addressLocality": "Zürich",
                "postalCode": "8001",
                "streetAddress": "Museumstrasse 2"
            },
            "geo": {
                "latitude": 47.378914,
                "longitude": 8.540993
            },
            "openingHours": "{\"en\":\"01.08.2022: 10:00-17:00, 03.09.2022: 18:00-23:59, 04.09.2022: -02:00, 12.09.2022: closed whole day\",\"fr\":\"01.08.2022 : 10:00-17:00, 03.09.2022 : 18:00-23:59, 04.09.2022 : -02:00, 12.09.2022 : fermé toute la journée\",\"de\":\"01.08.2022: 10:00–17:00, 03.09.2022: 18:00–23:59, 04.09.2022: –02:00, 12.09.2022: ganzer Tag geschlossen\",\"it\":\"01.08.2022: 10:00-17:00, 03.09.2022: 18:00-23:59, 04.09.2022: -02:00, 12.09.2022: chiuso tutto il giorno\"}",
            "image": {
                "dataGovernance": {
                    "provider": {
                        "acronym": "gdl",
                        "name": "Guidle",
                        "logo": {
                            "contentUrl": "https://img1.oastatic.com/img2/54940951/max/guidle.png",
                            "@id": "http://localhost:7071/api/imageObjects/img_wt1_14w4",
                            "identifier": "img_wt1_14w4"
                        },
                        "link": [
                            {
                                "url": "https://www.guidle.com/",
                                "type": "WebHomepage"
                            }
                        ],
                        "identifier": "gdl"
                    }
                },
                "contentUrl": "https://d37dhr5745n0y2.cloudfront.net/2/7c/6c/27c6c4c09252dbea7df36a90a3b556755e9d101d_692855345.jpg",
                "encodingFormat": "image/jpeg",
                "thumbnailUrl": "https://media-dev.discover.swiss/image/img_wt1_gjciffdef",
                "@id": "http://localhost:7071/api/imageObjects/img_wt1_gjciffdef",
                "identifier": "img_wt1_gjciffdef"
            },
            "name": "Räder, Rennen, Ruhm",
            "disambiguatingDescription": "Die Ausstellung macht eine Rundfahrt durch verschiedene Disziplinen des Radsports.",
            "description": "Die Ausstellung macht eine Rundfahrt durch verschiedene Disziplinen des Radsports.",
            "profileTag": [
                "profile-interest-1",
                "profile-interest-5",
                "profile-season-summer",
                "profile-season-winter"
            ],
            "schedule": [
                {
                    "byDay": [
                        "Tuesday",
                        "Wednesday"
                    ],
                    "startDate": "2022-07-15",
                    "endDate": "2022-10-16",
                    "startTime": "10:00:00",
                    "endTime": "17:00:00"
                },
                {
                    "byDay": [
                        "Thursday"
                    ],
                    "startDate": "2022-07-15",
                    "endDate": "2022-10-16",
                    "startTime": "10:00:00",
                    "endTime": "19:00:00"
                },
                {
                    "byDay": [
                        "Friday",
                        "Saturday",
                        "Sunday"
                    ],
                    "startDate": "2022-07-15",
                    "endDate": "2022-10-16",
                    "startTime": "10:00:00",
                    "endTime": "17:00:00"
                }
            ],
            "nextOccurrence": "2099-12-31T23:59:59+00:00",
            "recurredCount": 0,
            "link": [
                {
                    "url": "https://www.landesmuseum.ch/de/ausstellung/rader-rennen-ruhm-24009",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/en/events/zuerich/wheels-races-glory_A4mw5em",
                    "title": "Detail",
                    "type": "WebDetail"
                },
                {
                    "url": "https://www.landesmuseum.ch/de/ausstellung/rader-rennen-ruhm-24009",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/fr/evenements/zuerich/roues-courses-gloire_A4mw5em",
                    "title": "Detail",
                    "type": "WebDetail"
                },
                {
                    "url": "https://www.landesmuseum.ch/de/ausstellung/rader-rennen-ruhm-24009",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/de/veranstaltungen/zuerich/raeder-rennen-ruhm_A4mw5em",
                    "title": "Detail",
                    "type": "WebDetail"
                },
                {
                    "url": "https://www.landesmuseum.ch/de/ausstellung/rader-rennen-ruhm-24009",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/it/eventi/zuerich/ruote-corse-gloria_A4mw5em",
                    "title": "Detail",
                    "type": "WebDetail"
                }
            ],
            "autoTranslatedData": false,
            "priceInformation": "CHF 10.00 / 8.00",
            "organizer": {
                "address": {
                    "addressCountry": "CH",
                    "addressLocality": "Zürich",
                    "postalCode": "8021",
                    "streetAddress": "Postfach\nMuseumstrasse 2"
                },
                "contactPoint": {
                    "email": "info@nationalmuseum.ch",
                    "faxNumber": "+41 44 218 65 09",
                    "telephone": "+41 44 218 65 11",
                    "name": "Landesmuseum Zürich"
                },
                "name": "Landesmuseum Zürich"
            },
            "lastModified": "2022-08-22T23:18:20.962+00:00",
            "sourceId": [
                "866145548"
            ]
        },
        {
            "@id": "http://localhost:7071/api/events/eve_wt1_ijbgbciah",
            "identifier": "eve_wt1_ijbgbciah",
            "datasource": [
                "gdl"
            ],
            "dataGovernance": {
                "origin": [
                    {
                        "datasource": "gdl",
                        "sourceId": "891612807",
                        "created": "2022-08-22T16:57:31+00:00",
                        "lastModified": "2022-08-22T16:57:31+00:00",
                        "license": "C-All-Rights-Reserved",
                        "provider": {
                            "acronym": "gdl",
                            "name": "Guidle",
                            "logo": {
                                "contentUrl": "https://img1.oastatic.com/img2/54940951/max/guidle.png"
                            },
                            "link": [
                                {
                                    "url": "https://www.guidle.com/",
                                    "type": "WebHomepage"
                                }
                            ],
                            "identifier": "gdl"
                        },
                        "source": {
                            "name": "Landesmuseum Zürich"
                        }
                    }
                ]
            },
            "type": "Event",
            "additionalType": "VariousEvent",
            "address": {
                "addressLocality": "Zürich",
                "postalCode": "8001",
                "streetAddress": "Museumstrasse 2"
            },
            "geo": {
                "latitude": 47.378914,
                "longitude": 8.540993
            },
            "image": {
                "dataGovernance": {
                    "provider": {
                        "acronym": "gdl",
                        "name": "Guidle",
                        "logo": {
                            "contentUrl": "https://img1.oastatic.com/img2/54940951/max/guidle.png"
                        },
                        "link": [
                            {
                                "url": "https://www.guidle.com/",
                                "type": "WebHomepage"
                            }
                        ],
                        "identifier": "gdl"
                    }
                },
                "contentUrl": "https://d37dhr5745n0y2.cloudfront.net/8/a2/a3/8a2a3b4d02b4f8bb5cc589ed703e45a47d2f950c_705088139.jpg",
                "encodingFormat": "image/jpeg",
                "thumbnailUrl": "https://media-dev.discover.swiss/image/img_wt1_hafaiibdj",
                "@id": "http://localhost:7071/api/imageObjects/img_wt1_hafaiibdj",
                "identifier": "img_wt1_hafaiibdj"
            },
            "name": "Die lange Nacht der Zürcher Museen",
            "disambiguatingDescription": "Museumsnacht",
            "description": "Museumsnacht",
            "profileTag": [
                "profile-interest-5",
                "profile-season-summer",
                "profile-season-winter",
                "profile-mod-couple",
                "profile-mod-alone"
            ],
            "schedule": [
                {
                    "startDate": "2022-09-03",
                    "endDate": "2022-09-03",
                    "startTime": "18:00:00",
                    "endTime": "02:00:00"
                }
            ],
            "nextOccurrence": "2099-12-31T23:59:59+00:00",
            "recurredCount": 0,
            "link": [
                {
                    "url": "https://www.landesmuseum.ch",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/en/events/zuerich/lange-nacht-der-zuercher-museen_AcBh2ft",
                    "title": "Detail",
                    "type": "WebDetail"
                },
                {
                    "url": "https://www.landesmuseum.ch",
                    "title": "Homepage",
                    "type": "WebHomepage"
                },
                {
                    "url": "https://www.guidle.com/de/veranstaltungen/zuerich/die-lange-nacht-der-zuercher-museen_AcBh2ft",
                    "title": "Detail",
                    "type": "WebDetail"
                },
                {
                    "url": "https://www.landesmuseum.ch/de/veranstaltung/die-lange-nacht-der-zurcher-museen-24345",
                    "title": "Buchung",
                    "type": "WebBooking"
                }
            ],
            "autoTranslatedData": false,
            "ticketingContact": "Telefonnummer: +41 (0)44 218 66 00<br>E-Mail: reservationen@nationalmuseum.ch",
            "priceInformation": "CHF 25.00",
            "organizer": {
                "address": {
                    "addressCountry": "CH",
                    "addressLocality": "Zürich",
                    "postalCode": "8021",
                    "streetAddress": "Postfach\nMuseumstrasse 2"
                },
                "contactPoint": {
                    "email": "info@nationalmuseum.ch",
                    "faxNumber": "+41 44 218 65 09",
                    "telephone": "+41 44 218 65 11",
                    "name": "Landesmuseum Zürich"
                },
                "name": "Landesmuseum Zürich"
            },
            "lastModified": "2022-08-22T16:57:51.178+00:00",
            "sourceId": [
                "891612807"
            ]
        }
    ]
}

Products search example:

body

{
    "project": "<partnerProject>",
    "location": "civ_px9-s28_bggg",
    "combinedTypeTree": "Thing|Product",
    "facets": [],
    "currentPage": 1,
    "resultsPerPage": 2
}

The Response shows the available Products at the civ_px9-s28_bggg (National Museum Zurich) because they are connected to this place.

{
    "count": 1,
    "values": [
        {
            "@id": "http://localhost:7071/api/products/tom_tds00020013505989755",
            "identifier": "tom_tds00020013505989755",
            "datasource": [
                "tom"
            ],
            "dataGovernance": {
                "origin": [
                    {
                        "datasource": "tom",
                        "sourceId": "TDS00020013505989755",
                        "license": "CC BY-ND",
                        "provider": {
                            "acronym": "tom",
                            "name": "TOMAS",
                            "logo": {
                                "contentUrl": "https://cdn.discover.swiss/logos/tom.png"
                            },
                            "link": [
                                {
                                    "url": "https://www.tomas.ch",
                                    "type": "WebHomepage"
                                }
                            ],
                            "identifier": "tom"
                        },
                        "source": {
                            "acronym": "zht",
                            "name": "Zürich Tourismus",
                            "logo": {
                                "contentUrl": "https://cdn.discover.swiss/logos/zht.jpg",
                                "@id": "http://localhost:7071/api/imageObjects/img_px9_14w4",
                                "identifier": "img_px9_14w4"
                            },
                            "link": [
                                {
                                    "url": "https://www.zuerich.com",
                                    "type": "WebHomepage"
                                }
                            ],
                            "identifier": "zht"
                        }
                    }
                ]
            },
            "type": "Product",
            "additionalType": "Ticket",
            "image": {
                "dataGovernance": {
                    "provider": {
                        "acronym": "tom",
                        "name": "TOMAS",
                        "logo": {
                            "contentUrl": "https://cdn.discover.swiss/logos/tom.png"
                        },
                        "link": [
                            {
                                "url": "https://www.tomas.ch",
                                "type": "WebHomepage"
                            }
                        ],
                        "identifier": "tom"
                    }
                },
                "contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013505989762/TDS00020010010367324/TDS00020013506023136.jpg",
                "caption": "Landesmuseum",
                "encodingFormat": "image/jpeg",
                "thumbnailUrl": "https://media-dev.discover.swiss/image/img_942_9t8aaacaabdfagacdbdg",
                "@id": "http://localhost:7071/api/imageObjects/img_942_9t8aaacaabdfagacdbdg",
                "identifier": "img_942_9t8aaacaabdfagacdbdg"
            },
            "name": "Eintritt Landesmuseum",
            "profileTag": [
                "profile-interest-5",
                "profile-season-summer",
                "profile-season-winter",
                "profile-mod-couple",
                "profile-mod-alone"
            ],
            "link": [
                {
                    "url": "https://tours.zuerich.com/Zurich/experience/detail/TDS00020013505989755?globalReset=1",
                    "title": "Buchungslink",
                    "type": "WebBooking"
                }
            ],
            "autoTranslatedData": false,
            "priceInformation": "ab 0.-",
            "lastModified": "2022-09-02T15:02:18.112+00:00",
            "sourceId": [
                "TDS00020013505989755"
            ]
        }
    ]
}

Last update: February 1, 2024 17:37:15