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"
            ]
        }
    ]
}