Endpoint - /locations/{id}

Locaties worden omschreven door verschillende objecten, om te kunnen categoriseren heeft een locatie in ieder geval een category ingevuld. Om het mogelijk te maken dat een locatie, bijvoorbeeld hotel met restaurant, in meerdere categorieen zit is het mogelijk dat er extra_categories vastgelegd zijn. Naast de standaard contact en locatie gegevens is er een relevance dit beschrijft het gebied waar de locatie interresant voor is waarbij 40 op landelijk niveau is (bv. een sterren restaurant) en 10 op zeer plaatstelijk niveau (bijvoorbeeld de lokale snackbar)

Om op voorzieningen te kunnen filteren zijn er tags, een locatie kan aan meerdere tags gekoppeld zijn. Bijvoorbeeld op het moment dat er wifi aanwezig is, zal de locatie de tag "Wifi aanwezig" hebben, daarnaast kunnen er ook tags zijn zoals "Actief" welke het type activiteit omschrijft. Om meer inzicht te krijgen zijn deze tags weer ingedeeld en hierarchisch te bekijken bij het taggroups endpoint.

Specifieke details van locaties worden doorgegeven als LocationProperty objecten achter de key location_properties. Deze objecten hebben een textval of een intval welke een integer of tekst bevat, de ingevulde waarde is afhankelijk van het type. De mogelijke typen zijn:

1: Getal
2: Tekst
3: Tekstvak
4: URL
5: Afbeelding
6: Logo
7: Logo-vinkje
8: Select
9: Multi-select
10: Tijd
11: Datum-tijd
12: Vinkje
101: Booking.com
102: Hoteliers
103: Aantal sterren
104: Prijscategorie
105: Iframe (url)

Calls

Endpoint	Beschrijving
get/locations/{id}	Haal details op van een enkele locatie
get/locations/{id}/deals	Haal deals (arrangementen) van een locatie op
get/locations/{id}/events	Haal events van een locatie op
get/locations/{id}/suggestedEvents	Haal evenement suggesties bij bepaalde locatie op
get/locations/{id}/suggestedCalendar	Haal evenement suggesties bij bepaalde locatie op, in de kalenderweergave
get/locations/{id}/quizzes	Haal quizzen van een locatie op

Voorbeeld response

{
    "location": {
        "id": "11547",
        "url": "http://some.example.com/andere-groep/11547-buurse-erven-ed/",
        "canonical_url": "http://other.example.com/lege-groep/subgroep/11547-buurse-erven-ed/",
        "img": "http://other.example.com/img/8913/DSC_6044.jpg",
        "name": "Buurse Erven ED",
        "description": "Volledig gerenoveerde luxueuze vakantieappartement, met eigen ingang, deel uitma...",
        "latlong": "52.143307600,6.844577000",
        "lat": "52.1433076",
        "long": "6.844577",
        "address": "Wargerinksweg 3",
        "zipcode": "7481RD",
        "city": "Buurse",
        "phone": "06-22877641",
        "email": "foo@bar.nl",
        "website": "https://www.nu.nl/",
        "twittertag": "",
        "twitterurl": "http://twitter.com",
        "foursquareid": "",
        "facebookurl": "http://facebook.com",
        "youtubeurl": "",
        "bookingurl": "",
        "flickerurl": "",
        "linkedinurl": "",
        "instagram": "@instagram",
        "relevance": "40",
        "video": "embed://youtube/vb6_naqJa24",
        "content_html": "<!--B:TEXT-->\n<p>ED Vakantieappartement voor maximaal 2 personen. Me...",
        "content_src": "ED Vakantieappartement voor maximaal 2 personen. Met 1 x 2  persoonsbed.\n\n\nIn he...",
        "tags": [
            {
                "id": "54",
                "parentid": "0",
                "text": "Internet (draadloos, wifi)",
                "relevance": "15"
            },
            {
                "id": "49",
                "parentid": "0",
                "text": "Wasservice",
                "relevance": "15"
            },
            {
                "id": "53",
                "parentid": "0",
                "text": "Eigen parkeerplaats",
                "relevance": "15"
            },
            {
                "id": "46",
                "parentid": "0",
                "text": "Tuin",
                "relevance": "15"
            },
            {
                "id": "69",
                "parentid": "0",
                "text": "Landelijk gelegen",
                "relevance": "13"
            },
            {
                "id": "64",
                "parentid": "0",
                "text": "In/bij bos",
                "relevance": "13"
            }
        ],
        "topics": [
            {
                "id": "220",
                "name": "Onderwerp",
                "title": "Onderwerp",
                "subtitle": "Dit is een gewoon onderwerp",
                "video": "",
                "description": "Dit onderwerp is niet aan plaatsnamen gekoppeld. We laten een tip zien en een in...",
                "content_html": "<!--B:TEXT-->\n<p>Eos cum quo aliquid. Eveniet libero voluptate id de...",
                "content_src": "Eos cum quo aliquid. Eveniet libero voluptate id deserunt facere et numquam. Sin...",
                "iconclass": "",
                "image1": "http://other.example.com/img/7514/DSC_6001.jpg",
                "image2": "http://other.example.com/img/14547/DSC_6021.jpg",
                "image3": "http://other.example.com/img/8885/DSC_5985.jpg",
                "cities": "",
                "is_article_filter": "0",
                "is_landing_page": "1"
            },
            {
                "id": "221",
                "name": "Enschede",
                "title": "Enschede",
                "subtitle": "Stad van nu",
                "video": "embed://youtube/3T8ZLpCjEJk",
                "description": "Quod qui exercitationem quo earum. Repudiandae ut ea ipsam assumenda voluptas oc...",
                "content_html": "<!--B:TEXT-->\n<p>Voluptatibus et dicta sint fugit quidem. Magnam sap...",
                "content_src": "Voluptatibus et dicta sint fugit quidem. Magnam sapiente repellat iusto quia non...",
                "iconclass": "Accomodation",
                "image1": "http://other.example.com/img/8890/DSC_5986.jpg",
                "image2": "http://other.example.com/img/8865/DSC_6000.jpg",
                "image3": "",
                "cities": "Enschede\nUsselo\nBoekelo",
                "is_article_filter": "0",
                "is_landing_page": "1"
            }
        ],
        "category": {
            "id": "1179",
            "url": "http://some.example.com/multimove_import/",
            "name": "Multimove import",
            "desc": "Tijdelijke categorie met locaties uit de multimove database",
            "parentcat": "",
            "appicon": "",
            "img": ""
        },
        "extra_categories": [
            {
                "id": "1139",
                "url": "http://some.example.com/overnachten/bed-en-breakfast/",
                "name": "Bed & Breakfast",
                "desc": "",
                "parentcat": "1137",
                "appicon": "",
                "img": ""
            }
        ],
        "openingHours": [
            {
                "id": "528",
                "is_closed": "1",
                "is_multiday": "",
                "day": "1",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "529",
                "is_closed": "1",
                "is_multiday": "",
                "day": "2",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "530",
                "is_closed": "1",
                "is_multiday": "",
                "day": "3",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "531",
                "is_closed": "1",
                "is_multiday": "",
                "day": "4",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "532",
                "is_closed": "1",
                "is_multiday": "",
                "day": "5",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "533",
                "is_closed": "",
                "is_multiday": "",
                "day": "6",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "36000",
                "from_time": "10:00",
                "to_stamp": "46800",
                "to_time": "13:00"
            },
            {
                "id": "585",
                "is_closed": "",
                "is_multiday": "",
                "day": "6",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "50400",
                "from_time": "14:00",
                "to_stamp": "61200",
                "to_time": "17:00"
            },
            {
                "id": "534",
                "is_closed": "",
                "is_multiday": "",
                "day": "7",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "36000",
                "from_time": "10:00",
                "to_stamp": "46800",
                "to_time": "13:00"
            },
            {
                "id": "586",
                "is_closed": "",
                "is_multiday": "",
                "day": "7",
                "validfrom_stamp": "1075590000",
                "validfrom_date": "2004-02-01",
                "validuntil_stamp": "1091311200",
                "validuntil_date": "2004-08-01",
                "from_stamp": "50400",
                "from_time": "14:00",
                "to_stamp": "61200",
                "to_time": "17:00"
            },
            {
                "id": "578",
                "is_closed": "1",
                "is_multiday": "",
                "day": "1",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "579",
                "is_closed": "1",
                "is_multiday": "",
                "day": "2",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "580",
                "is_closed": "1",
                "is_multiday": "",
                "day": "3",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "581",
                "is_closed": "1",
                "is_multiday": "",
                "day": "4",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "582",
                "is_closed": "1",
                "is_multiday": "",
                "day": "5",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "",
                "from_time": "",
                "to_stamp": "",
                "to_time": ""
            },
            {
                "id": "583",
                "is_closed": "",
                "is_multiday": "",
                "day": "6",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "36000",
                "from_time": "10:00",
                "to_stamp": "46800",
                "to_time": "13:00"
            },
            {
                "id": "584",
                "is_closed": "",
                "is_multiday": "",
                "day": "7",
                "validfrom_stamp": "1091311200",
                "validfrom_date": "2004-08-01",
                "validuntil_stamp": "1075590000",
                "validuntil_date": "2004-02-01",
                "from_stamp": "36000",
                "from_time": "10:00",
                "to_stamp": "46800",
                "to_time": "13:00"
            }
        ],
        "openingRemark": "Opmerking bij de openingstijden",
        "tempclosed": "",
        "tempclosed_until": "2021-10-10",
        "prices": [
            {
                "location_id": "11547",
                "price_category_id": "8",
                "label": "Entreeprijs",
                "cents": "1000",
                "str": "\u20ac 10,00",
                "price_category": {
                    "id": "8",
                    "order": "1",
                    "content": [],
                    "label": "Entreeprijs"
                }
            },
            {
                "location_id": "11547",
                "price_category_id": "22",
                "label": "Entreeprijs kinderen (t/m 12 jaar)",
                "cents": "1200",
                "str": "\u20ac 12,00",
                "price_category": {
                    "id": "22",
                    "order": "2",
                    "content": [],
                    "label": "Entreeprijs kinderen (t/m 12 jaar)"
                }
            }
        ],
        "priceRemark": "Als u drie weken van te voren reserveert geldt een korting van 2 euro per ticket...",
        "gallery": [
            {
                "id": "7406",
                "url": "http://other.example.com/img/7406/7803-1.jpg"
            },
            {
                "id": "7407",
                "url": "http://other.example.com/img/7407/7803-2.jpg"
            },
            {
                "id": "8896",
                "url": "http://other.example.com/img/8896/DSC_6049.jpg"
            },
            {
                "id": "8907",
                "url": "http://other.example.com/img/8907/DSC_6045.jpg"
            },
            {
                "id": "8911",
                "url": "http://other.example.com/img/8911/DSC_6050.jpg"
            },
            {
                "id": "8915",
                "url": "http://other.example.com/img/8915/P1020186.JPG"
            },
            {
                "id": "8917",
                "url": "http://other.example.com/img/8917/P1020167.JPG"
            },
            {
                "id": "8935",
                "url": "http://other.example.com/img/8935/P1020283.JPG"
            }
        ],
        "location_properties": [
            {
                "property_id": "3",
                "property_name": "Hoteliers",
                "location_id": "11547",
                "type": "102",
                "type_name": "Hoteliers",
                "intval": "0",
                "textval": "http://engines.hoteliers.com/nl/3/groupengine/hotel/310/"
            },
            {
                "property_id": "4",
                "property_name": "Aantal sterren",
                "location_id": "11547",
                "type": "103",
                "type_name": "Aantal sterren",
                "intval": "3",
                "textval": ""
            },
            {
                "property_id": "6",
                "property_name": "Webshop",
                "location_id": "11547",
                "type": "4",
                "type_name": "URL",
                "intval": "0",
                "textval": "http://webshop.nl"
            },
            {
                "property_id": "7",
                "property_name": "Prijscategorie",
                "location_id": "11547",
                "type": "104",
                "type_name": "Prijscategorie",
                "intval": "2",
                "textval": ""
            },
            {
                "property_id": "9",
                "property_name": "Periview URL",
                "location_id": "11547",
                "type": "105",
                "type_name": "Iframe (url)",
                "intval": "0",
                "textval": "http://tour.periview.nl/310_vvv_twente/vvv_oldenzaal/hotel_de_wilmersberg"
            },
            {
                "property_id": "15",
                "property_name": "Testafbeelding",
                "location_id": "11547",
                "type": "5",
                "type_name": "Afbeelding",
                "intval": "18104",
                "textval": "http://other.example.com/img/18104/IMG-20190525-WA0033.jpg"
            },
            {
                "property_id": "17",
                "property_name": "Afbeeldingsvinkje",
                "location_id": "11547",
                "type": "7",
                "type_name": "Logo-vinkje",
                "intval": "0",
                "textval": "http://other.example.com/img/15394/puzzel_los.jpg"
            }
        ],
        "lastmodified": "2021-10-11T12:20:08+02:00",
        "lastmod_timestamp": "2021-10-11 12:20:08",
        "lastmod_stamp": "1633947608",
        "euregiopartner": ""
    }
}

Details velden

url

Het webadres van de locatie in de huidige site

canonical_url

Een locatie kan in meerdere sites voorkomen, canonical_url wijst naar de locatie in de bron-website

relevance

De allure van een locatie, 10 betekent lokaal, 20 regionaal, 30 landelijk en 40 duidt op een locatie van internationale allure

video

Externe video gecodeerd in een uri in de vorm embed://{service}/{videoid}. Service kan zowel youtube als vimeo zijn

tags

Een array met alle tags gekoppeld aan de locatie. Zie het tags-endpoint voor een beschrijving van de velden

topics

Een array met alle onderwerpen gekoppeld aan de locatie. Zie het topics-endpoint voor een beschrijving van de velden

category

De hoofdcategorie waarin de locatie is geplaatst, dit geeft aan wat voor een soort locatie het is

extra_categories

Een locatie kan in meerdere categorieen zijn geplaatst, bijvoorbeeld een hotel / restaurant

openingHours

Een array met objecten die de openingstijden aangeven. Elk element heeft de volgende velden:

openingHour > is_closed: True wanneer de locatie deze dag is gesloten
openingHour > is_multiday: De eindtijd ligt op de volgende dag, bijvoorbeeld voor een café dat open is van 16:00u - 02:00u
openingHour > day: Dag van de week als cijfer, 1 voor maandag, 7 voor zondag.
openingHour > valid_from_stamp / _date: Wanneer een datum is ingesteld dan gelden de openingstijden maar een deel van het jaar. Alle datums zijn in het (schrikkel-) jaar 2004 geoplaatse. Alleen de maand en dag zijn relevant.

Zonder periode gelden de tijden het hele jaar.
openingHour > valid_until_stamp / _date: Einddatum van de periode waarin de tijden gelden.
openingHour > from_stamp: Tijdstip van openen, uitgedrukt in aantal seconden sinds 0:00
openingHour > from_time: Tijdstip van openen
openingHour > to_stamp: Tijdstip van sluiten, uitgedrukt in aantal seconden sinds 0:00
openingHour > to_time: Tijdstip van sluiten

openingRemark

Opmerking bij de openingstijden

tempclosed

Boolean die aangeeft of de locatie tijdelijk gesloten is, voor onbepaalde tijd

tempclosed_until

Datum die aangeeft of de locatie tijdelijk gesloten is. Als deze datum in de toekomst ligt dan is de locatie tijdelijk gesloten, ongeacht de waarde van tempclosed

prices

Een array met objecten die de toegangsprijzen weergeven. Elk element heeft de volgende velden:

price > location_id: Id van de locatie
price > price_category_id: ID van het prijstype
price > label: Label van het prijstype
cents: De prijs in centen
price > str: De prijs opgemaakt als tekst, inclusief valuta en "gratis" in geval van een prijs van 0.
price > price_category: Een dump van het price_category object

price_remark

Opmerking bij de prijsinformatie. Dit veld kan ook gevuld zijn als er geen prijzem zijn ingevoerd

gallery

Een array met extra beeldmateriaal bij de locatie. Elk element bevat een object met een image id en verwijzing naar de url van de foto

location_properties

Een array met aanvullende kenmerken van de locatie. Elek element bevat de volgende velden"

property > property_id

ID van het kenmerk

property > property_naam

Naam van het kenmerk

property > location_id

Id van de locatie

property > type

Typecode van het kenmerk, hieruit kan worden afgeleid wat voor een soort data te verwachten is.

1: integer, de waarde staat in intval
2: (single line) string, de waarde staat in textval
3: (multi line) string, de waarde staat in textval
4: een webadres (url) de waarde staat in textval
5: een afbeelding. In intval staat het ID van de afbeelding, textval bevat een URL naar de afbeelding
6: een logo, dit is hetzelfde als een afbeelding, het onderscheid is gemaakt omdat logo's zich slecht lenene voor uitsnedes
7: een afbeelding (die gekoppeld is aan het kenmerk). textval bevat een URL naar de afbeelding
8: een keuze uit een vaste lijst opties. textval bevat de waarde
9: een (of meerdere) keuzes uit een vaste lijst opties. textval bevat de waarden, 1 per regel
10: een tijd, textval bevat de waarde als H:M
11: een tijdstip met datum, textval bevat de waarde als Y-m-d H:i:s
12: een vinkje / boolean. textval bevat "1" als het vinkje geldt voor de locatie
101: [deprecated] booking.com koppeling
102: [deprecated] hoteliers koppeling
103: Een sterrenrating, intval bevat het aantal sterren.
104: Een aanduiding van een prijsniveau, intval bevat een getal van 1 tot 3.
105: Een koppeling die in met een iframe wordt ontsloten. Textval bevat het url met de inhoud.

property > typename

Naam van het type kenmerk

property > intval

Integerwaarde van het kenmerk

property > tetxval

Tekstwaarde van het kenmerk

lastmodified

Modification date in ISO 8601 formaat

lastmod_timestamp

Modification date in Y-m-d H:i:s

lastmod_stamp

Unix timestamp van de modification date

euregiopartner

"1" wanneer de locatie een euregio-partner is