Données relatives aux point d'intérêts

Points remarquables 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 points d'intérêt

Emplacement des points d'intérêt

Modèle de données

{
  "id": "PointOfInterest:OTCM-POI-PATRIMOINE_CULTUREL-821669",
  "type": "PointOfInterest",
  "address": {
    "type": "PostalAddress",
    "value": {
      "addressCountry": "FR",
      "postalCode": "06300",
      "addressLocality": "Nice"
    }
  },
  "alternateName": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "fr": "Sentier découverte du Parc du Mont Vinaigrier"
      }
    }
  },
  "catchPhrase": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "Back to nature on the edge of town",
        "fr": "Retour à la nature à la lisière de la ville"
      }
    }
  },
  "dataProvider": {
    "type": "Text",
    "value": "Office de Tourisme Métropolitain de Nice Côte d%27Azur"
  },
  "dateCreated": {
    "type": "DateTime",
    "value": "2016-05-19T21:36:01.209Z"
  },
  "dateModified": {
    "type": "DateTime",
    "value": "2016-11-30T18:21:38.742Z"
  },
  "description": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "fr": "Comme l’écrivain niçois Louis Nucéra, vous penserez que “la Beauté qui se voulait éternelle” avait élu domicile sur ce coin de terre privilégié.Ce parc de 31 hectares, propriété du Conservatoire du littoral, est géré par le Département depuis 1988.\r\n\r\nLes vestiges d’un mur cyclopéen caractéristique du vrai castellaras confirment l’existence d’une petite communauté ligure aux activités pastorales et agricoles.\r\n\r\nLe mont Vinaigrier est constitué d%27un plateau calcaire d%27une altitude de 370 mètres et de versants plus ou moins abrupts. Sur la partie où la pente est la plus douce, on trouve des sols plus épais où l%27homme a installé des terrasses cultivables. Le plateau est composé de grands pins d’Alep et de chênes verts. Sur le talus, une forêt de frênes à fleurs, espèce relativement rare dans la région, fleurit au mois de mai.\r\n\r\nA la lisière de Nice une faune variée et dense vit en toute quiétude : petits mammifères %28hérissons, écureuils, renards, blaireaux%29, ainsi que 59 espèces d%27oiseaux, sédentaires %28mésanges charbonnières, éperviers d%27Europe, fauvettes mélanocéphales…%29 et migrateurs %28martinets noirs, gobemouches noirs, rouges-queues à front blanc…%29\r\n\r\nVous trouverez dans le Parc :\r\n- une salle d’interprétation : La maison du Vinaigrier abrite une exposition pédagogique sur l’évolution du site %28horaires d’ouverture : renseignements au 04.89.04.54.80%29.\r\n- une aire d’observation : Un observatoire situé en partie sommitale du parc vous offre une vue imprenable sur le littoral depuis la baie de Villefranche jusqu%27au massif de l%27Estérel.\r\n- un sentier thématique : Il vous permettra de découvrir les pratiques d’irrigation liées aux activités agricoles du passé %28oliveraies, cultures maraîchères en restanque, …%29."
      }
    }
  },
  "location": {
    "type": "geo:json",
    "value": {
      "coordinates": [
        7.304128,
        43.713575
      ],
      "type": "Point"
    }
  },
  "mainMedia": {
    "type": "StructuredValue",
    "value": {
      "contentUrl": "https://static.apidae-tourisme.com/filestore/objets-touristiques/images/120/168/1615992.jpg",
      "name": "IMAGE",
      "description": "IMAGE"
    }
  },
  "name": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "fr": "Sentier découverte du Parc du Mont Vinaigrier"
      }
    }
  },
  "nodeId": {
    "type": "Text",
    "value": "MNCA"
  },
  "openingHoursSpecification": {
    "type": "StructuredValue",
    "value": [
      {
        "dayOfWeek": "Monday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Tuesday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Wednesday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Thursday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Tuesday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Friday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Saturday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      },
      {
        "dayOfWeek": "Sunday",
        "validThrough": "2016-12-31",
        "validFrom": "2016-01-01"
      }
    ]
  },
  "openingHoursText": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "All year round, daily.",
        "it": "Tutto l%27anno, ogni giorno.",
        "fr": "Toute l%27année, tous les jours."
      }
    }
  },
  "region": {
    "type": "Text",
    "value": "MNCA"
  },
  "shortDescription": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "Back to nature on the edge of town",
        "fr": "Retour à la nature à la lisière de la ville"
      }
    }
  },
  "source": {
    "type": "LanguageProperty",
    "value": {
      "languageMap": {
        "en": "APIDAE",
        "it": "APIDAE",
        "fr": "APIDAE"
      }
    }
  },
  "website": {
    "type": "Text",
    "value": "http://m.conservatoire-du-littoral.fr/siteLittoralMobile/65/64-le-mont-vinaigrier-06_alpesmaritimes.htm"
  }
}

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 Points d’intérêts touristiques de type "PointOfInterest"
  • 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 Points d’intérêts touristiques de type "PointOfInterest"

curl -X GET "https://api.nicecotedazur.org/nca/tourism/poi/?idPattern=^PointOfInterest:&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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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/poi/histo/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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 Points d’intérêts touristiques de type "PointOfInterest"

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/poi/?idPattern=^PointOfInterest:&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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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/poi/histo/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669?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 Points d’intérêts touristiques de type "PointOfInterest"

const url = "https://api.nicecotedazur.org/nca/tourism/poi/"
 
const params = {
    idPattern: '^PointOfInterest:',
    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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
 
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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
 
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/poi/histo/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
 
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 Points d’intérêts touristiques de type "PointOfInterest"

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/tourism/poi/"
searchParams = {
  'idPattern': "^PointOfInterest:",
  '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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
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/poi/histo/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669"
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 Points d’intérêts touristiques de type "PointOfInterest"

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/poi/";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "idPattern=^PointOfInterest:&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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669";
 
            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/poi/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669";
 
            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/poi/histo/PointOfIntrest:OTCM-POI-PATRIMOINE_CULTUREL-821669";
 
            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);
        }
    }
}