Données relatives aux évènements touristiques

Evénement touristiques proposés par l’Office de Tourisme Métropolitain Nice Côte d’Azur. La liste ci-dessous représente un échantillon des données.

Liste des événements touristiques

Emplacement des événements touristiques

Modèle de données

{
  "id": "TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466",
  "type": "TouristEvent",
  "address": {
    "type": "PostalAddress",
    "value": {
      "addressCountry": "FR",
      "postalCode": "06000",
      "addressLocality": "Nice"
    }
  },
  "alternateName": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "Salon ID Week-End",
        "it": "Salon ID Week-End",
        "fr": "Salon ID Week-End"
      }
    }
  },
  "category": {
    "type": "StructuredValue",
    "value": [
      4
    ]
  },
  "dataProvider": {
    "type": "Text",
    "value": "Office de Tourisme Métropolitain de Nice Côte d%27Azur"
  },
  "dateCreated": {
    "type": "DateTime",
    "value": "2020-02-13T09:00:25.434Z"
  },
  "dateModified": {
    "type": "DateTime",
    "value": "2024-03-04T07:49:17.887Z"
  },
  "description": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "Escape to the Id Week-End show offering many ideas for stays or activities! The Provence-Alpes-Côte-d%27Azur region, but also Monaco, Corsica and nearby Italy are full of exceptional sites and activities between the sea and the mountains that are often little known to everyone. \r\n\r\nDive into our different worlds at your disposal! \r\nWhether you%27re an adventurer or a specialist in idleness, an inveterate seeker of new tourism, a lover of sports holidays in the mountains or a family cocooning in the countryside, you%27ll find your Id Week-End!",
        "it": "Fuga al salone Id Week-End che offre molte idee per soggiorni o attività! La regione Provenza-Alpi-Costa Azzurra, ma anche Monaco, la Corsica e la vicina Italia sono pieni di siti e attività eccezionali tra il mare e la montagna che sono spesso poco conosciuti da tutti. \r\n\r\nImmergiti nei nostri diversi mondi a tua disposizione! \r\nChe tu sia un avventuriero o uno specialista dell%27ozio, un cercatore inveterato di nuovo turismo, un amante delle vacanze sportive in montagna o una famiglia che si coccola in campagna, troverai il tuo Id Week-End!",
        "fr": "Évadez-vous au salon Id Week-End proposant de nombreuses idées de séjours ou d%27activités ! La région Provence-Alpes-Côte-d%27Azur mais aussi Monaco, la Corse ou la proche Italie recèlent de sites et d%27activités d%27exception entre mer et montagne souvent peu connus de tous. \r\n\r\nPlongez dans nos différents univers mis à votre disposition ! \r\nBaroudeurs ou spécialistes du farniente, chercheurs invétérés de la nouveauté touristique, amateurs de vacances sportives à la montagne ou de cocooning en famille à la campagne : vous trouverez votre Id Week-End !"
      }
    }
  },
  "email": {
    "type": "Text",
    "value": "info@idweekend.fr"
  },
  "isAccessibleForFree": {
    "type": "Boolean",
    "value": true
  },
  "location": {
    "type": "geo:json",
    "value": {
      "coordinates": [
        7.269628,
        43.696813
      ],
      "type": "Point"
    }
  },
  "mainMedia": {
    "type": "StructuredValue",
    "value": {
      "contentUrl": "https://static.apidae-tourisme.com/filestore/objets-touristiques/images/55/128/18317367.png",
      "name": "IMAGE",
      "description": "IMAGE"
    }
  },
  "name": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "Salon ID Week-End",
        "it": "Salon ID Week-End",
        "fr": "Salon ID Week-End"
      }
    }
  },
  "nodeId": {
    "type": "Text",
    "value": "MNCA"
  },
  "openingHoursSpecification": {
    "type": "StructuredValue",
    "value": [
      {
        "dayOfWeek": "Monday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Tuesday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Wednesday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Thursday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Tuesday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Friday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Saturday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      },
      {
        "dayOfWeek": "Sunday",
        "validThrough": "2024-04-07",
        "validFrom": "2024-04-05"
      }
    ]
  },
  "openingHoursText": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "From Friday 5 to Sunday 7 April 2024.",
        "it": "Dal venerdì 5 a domenica 7 aprile 2024.",
        "fr": "Du vendredi 5 au dimanche 7 avril 2024."
      }
    }
  },
  "region": {
    "type": "Text",
    "value": "MNCA"
  },
  "source": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "APIDAE",
        "it": "APIDAE",
        "fr": "APIDAE"
      }
    }
  },
  "telephone": {
    "type": "Text",
    "value": "+33%280%29675300765"
  },
  "website": {
    "type": "Text",
    "value": "https://www.idweekend.fr/"
  }
}

Documentation relative à l'API

La documentation est utile aux développeurs désirant utiliser l'API fournie par la Métropole Nice Côte d'Azur.

Exemple de code

• Temps réel – Dernière valeur reçue au moment de la requête
  • Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"
  • Cas d'usage 2 : Renvoie les données d'un ID donné
  • Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné
• Historique
  • Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

Curl

• Temps réel - Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"

curl -X GET "https://api.nicecotedazur.org/nca/tourism/touristevent/?idPattern=^TouristEvent:&api_key=API_KEY"

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?api_key=API_KEY"

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?attrs=image&api_key=API_KEY"

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/tourism/touristevent/histo/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?attrs=image&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"

Java

• Temps réel - Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case1 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/tourism/touristevent/?idPattern=^TouristEvent:&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case2 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case3 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?attrs=image&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case4 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/tourism/touristevent/histo/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466?attrs=image&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

Javascript

• Temps réel - Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"

const url = "https://api.nicecotedazur.org/nca/tourism/touristevent/"
 
const params = {
    idPattern: '^TouristEvent:',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

const url = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
 
const params = {
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
 
const params = {
    attrs: 'image',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/tourism/touristevent/histo/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
 
const params = {
    attrs: 'image',
    fromDate: '2023-07-01T09:00:00',
    toDate: '2023-07-31T09:00:00',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

Python

• Temps réel - Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/tourism/touristevent/"
searchParams = {
  'idPattern': "^TouristEvent:",
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
searchParams = {
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
searchParams = {
  'attrs': 'image',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/tourism/touristevent/histo/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466"
searchParams = {
  'attrs': 'image',
  'fromDate': '2023-07-01T09:00:00',
  'toDate': '2023-07-31T09:00:00',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

C#

• Temps réel - Cas d'usage 1 : Renvoie les Evènements touristiquess de type "TouristEvent"

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case1
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/tourism/touristevent/";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "idPattern=^TouristEvent:&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case2
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case3
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/tourism/touristevent/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=image&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case4
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/tourism/touristevent/histo/TouristEvent:OTCM-TOURISTEVENT-FETE_ET_MANIFESTATION-5447466";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=image&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}