Pas à pas – Insérer une carte OpenStreetMap sur votre site

11 mai 2018 - : HTML Javascript jQuery - : 21 commentaire.s

Pas à pas – Insérer une carte OpenStreetMap sur votre site

Google a annoncé il y a quelques jours que son API Google Maps Javascript va devenir payante pour un grand nombre de développeurs, habitués jusqu’à maintenant à une gratuité totale.

Pour être clair, de nombreux sites conserveront la gratuité, mais vous ne serez pas à l’abri d’une facturation si votre site venait à connaître un pic de fréquentation.

Voici une alternative gratuite à Google Maps pour votre site et une mise en œuvre reprenant les exemples indiqués dans l’article Pas à Pas – Insérer une carte Google Maps avec l’API Google Maps Javascript

OpenStreetMap

Pour commencer, parlons un peu d’OpenStreetMap. Il s’agit d’un projet international fondé en 2004 dans le but de créer une carte libre du monde.

En plus de fournir des cartes, open source, de nombreuses API permettent de rendre leur utilisation très proche de Google Maps, ce qui en fait une alternative très crédible.

Initialisation de l’API

Carte OpenStreetMap

Pour initialiser l’API, nous devrons utiliser une bibliothèque Javascript qui nous donnera toutes les ressources pour intéragir avec les serveurs d’OpenStreetMap. La librairie que j’utilise est Leaflet. Nous allons créer un fichier HTML contenant le code ci-dessous

<!DOCTYPE html>
<html>
	<head>
        <meta charset="utf-8">
        <!-- Nous chargeons les fichiers CDN de Leaflet. Le CSS AVANT le JS -->
        <link rel="stylesheet" href="https://unpkg.com/leaflet@1.3.1/dist/leaflet.css" integrity="sha512-Rksm5RenBEKSKFjgI3a41vrjkw4EVPlJ3+OiI65vTjIdo9brlAacEuKOiQ5OFh7cOI1bkDwLqdLw3Zg0cRJAAQ=="
            crossorigin="" />
        <script src="https://unpkg.com/leaflet@1.3.1/dist/leaflet.js" integrity="sha512-/Nsx9X4HebavoBvEBuyp3I7od5tA0UzAxs+j83KgC8PU0kgB4XiK4Lfe4y4cgBtaRJQEIFCW+oC506aPT2L1zw=="
            crossorigin=""></script>
		<script type="text/javascript">
			// On initialise la latitude et la longitude de Paris (centre de la carte)
			var lat = 48.852969;
			var lon = 2.349903;
			var macarte = null;
			// Fonction d'initialisation de la carte
			function initMap() {
				// Créer l'objet "macarte" et l'insèrer dans l'élément HTML qui a l'ID "map"
                macarte = L.map('map').setView([lat, lon], 11);
                // Leaflet ne récupère pas les cartes (tiles) sur un serveur par défaut. Nous devons lui préciser où nous souhaitons les récupérer. Ici, openstreetmap.fr
                L.tileLayer('https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png', {
                    // Il est toujours bien de laisser le lien vers la source des données
                    attribution: 'données © <a href="//osm.org/copyright">OpenStreetMap</a>/ODbL - rendu <a href="//openstreetmap.fr">OSM France</a>',
                    minZoom: 1,
                    maxZoom: 20
                }).addTo(macarte);
            }
			window.onload = function(){
				// Fonction d'initialisation qui s'exécute lorsque le DOM est chargé
				initMap(); 
			};
		</script>
		<style type="text/css">
			#map{ /* la carte DOIT avoir une hauteur sinon elle n'apparaît pas */
				height:400px;
			}
		</style>
		<title>Carte</title>
	</head>
	<body>
		<div id="map">
			<!-- Ici s'affichera la carte -->
		</div>
	</body>
</html>

Ajout d’un marqueur

Bien sûr, cette carte ne fait apparaître aucun marqueur de position. Il pourrait être intéressant de mettre un marqueur aux coordonnées que nous avons entrées.

Carte OpenStreetMap avec marqueur

 

Pour ce faire, nous allons insérer le code d’ajout de marqueur ci-dessous juste avant la fermeture de notre fonction initMap (au dessus de l’accolade située en ligne 26 sur le code ci-dessus).

// Nous ajoutons un marqueur
var marker = L.marker([lat, lon]).addTo(macarte);
 

Ajout de plusieurs marqueurs

Bien sûr, nous pourrions avoir besoin de plusieurs marqueurs. OpenStreetMap nous propose donc d’ajouter ces différents points en effectuant une boucle sur un tableau contenant les différentes coordonnées.

Carte OpenStreetMap avec marqueurs

Dans notre exemple, nous aurons 4 points correspondant à 4 villes. Nous allons initialiser un tableau json « en dur » et le parcourir pour placer les différents marqueurs.

Voici la fonction initMap mise à jour, les lignes ajoutées sont en surbrillance.

// Nous initialisons une liste de marqueurs
var villes = {
	"Paris": { "lat": 48.852969, "lon": 2.349903 },
	"Brest": { "lat": 48.383, "lon": -4.500 },
	"Quimper": { "lat": 48.000, "lon": -4.100 },
	"Bayonne": { "lat": 43.500, "lon": -1.467 }
};
// Fonction d'initialisation de la carte
function initMap() {
	// Créer l'objet "macarte" et l'insèrer dans l'élément HTML qui a l'ID "map"
	macarte = L.map('map').setView([lat, lon], 11);
	// Leaflet ne récupère pas les cartes (tiles) sur un serveur par défaut. Nous devons lui préciser où nous souhaitons les récupérer. Ici, openstreetmap.fr
	L.tileLayer('https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png', {
		// Il est toujours bien de laisser le lien vers la source des données
		attribution: 'données © OpenStreetMap/ODbL - rendu OSM France',
		minZoom: 1,
		maxZoom: 20
	}).addTo(macarte);
	// Nous parcourons la liste des villes
	for (ville in villes) {
		var marker = L.marker([villes[ville].lat, villes[ville].lon]).addTo(macarte);
	}               	
}

Les bulles d’information

Il peut être nécessaire, dans certaines utilisations des cartes OpenStreetMap, de faire apparaître une bulle d’information lorsque l’utilisateur cliquera sur le marqueur.

Carte OpenStreetMap avec popups

Dans l’API, ces bulles sont appelées « Popup ». Elles doivent être « attachées » à chacun des marqueurs et s’activer au clic de l’utilisateur.

Voici le code à ajouter pour nous permettre d’afficher la ville correspondant au marqueur

// Nous parcourons la liste des villes
for (ville in villes) {
	var marker = L.marker([villes[ville].lat, villes[ville].lon]).addTo(macarte);
	// Nous ajoutons la popup. A noter que son contenu (ici la variable ville) peut être du HTML
	marker.bindPopup(ville);
}               	

Les marqueurs personnalisés

L’API Leaflet permet de personnaliser les marqueurs affichés sur la carte.

Avant d’écrire du code, il sera nécessaire de créer les images correspondantes.

Dans l’exemple suivant, nous allons utiliser une image appelée « autres.png », d’une taille de 64 par 64 pixels, qui sera accessible depuis le chemin http://localhost/carte/icons, ce qui donnera un résultat comme celui ci-dessous.

Carte OpenStreetMap avec marqueurs personnalisés

Voici le code à modifier

function initMap() {
	// Nous définissons le dossier qui contiendra les marqueurs
	var iconBase = 'http://localhost/carte/icons/';
	// Créer l'objet "macarte" et l'insèrer dans l'élément HTML qui a l'ID "map"
	macarte = L.map('map').setView([lat, lon], 11);
	// Leaflet ne récupère pas les cartes (tiles) sur un serveur par défaut. Nous devons lui préciser où nous souhaitons les récupérer. Ici, openstreetmap.fr
	L.tileLayer('https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png', {
		// Il est toujours bien de laisser le lien vers la source des données
		attribution: 'données © OpenStreetMap/ODbL - rendu OSM France',
		minZoom: 1,
		maxZoom: 20
	}).addTo(macarte);
	// Nous parcourons la liste des villes
	for (ville in villes) {
		// Nous définissons l'icône à utiliser pour le marqueur, sa taille affichée (iconSize), sa position (iconAnchor) et le décalage de son ancrage (popupAnchor)
		var myIcon = L.icon({
			iconUrl: iconBase + "autres.png",
			iconSize: [50, 50],
			iconAnchor: [25, 50],
			popupAnchor: [-3, -76],
		});
		var marker = L.marker([villes[ville].lat, villes[ville].lon], { icon: myIcon }).addTo(macarte);
		marker.bindPopup(ville);
	}               	
}

Le regroupement de marqueurs

Lorsque de nombreux marqueurs se trouvent sur une carte, il peut être nécessaire de les regrouper pour faciliter sa lecture, ceux-ci apparaissant séparés lorsque le zoom le permet.

Carte OpenStreetMap avec regroupement de marqueurs

Les groupes de marqueurs s’appellent des « clusters ».

L’API Leaflet ne permet pas de faire des regroupements de marqueurs. Nous utiliserons une bibliothèque complémentaire appelée Markercluster.

Le code de notre page complète ressemblera à ceci. Les lignes ajoutées ou modifiées sont indiquées

<!DOCTYPE html>
<html>
	<head>
        <meta charset="utf-8">
        <!-- Nous chargeons les fichiers CDN de Leaflet. Le CSS AVANT le JS -->
        <link rel="stylesheet" href="https://unpkg.com/leaflet@1.3.1/dist/leaflet.css" integrity="sha512-Rksm5RenBEKSKFjgI3a41vrjkw4EVPlJ3+OiI65vTjIdo9brlAacEuKOiQ5OFh7cOI1bkDwLqdLw3Zg0cRJAAQ=="
            crossorigin="" />
        <link rel="stylesheet" type="text/css" href="https://unpkg.com/leaflet.markercluster@1.3.0/dist/MarkerCluster.css" />
        <link rel="stylesheet" type="text/css" href="https://unpkg.com/leaflet.markercluster@1.3.0/dist/MarkerCluster.Default.css" />
        <script src="https://unpkg.com/leaflet@1.3.1/dist/leaflet.js" integrity="sha512-/Nsx9X4HebavoBvEBuyp3I7od5tA0UzAxs+j83KgC8PU0kgB4XiK4Lfe4y4cgBtaRJQEIFCW+oC506aPT2L1zw=="
            crossorigin=""></script>
        <script type='text/javascript' src='https://unpkg.com/leaflet.markercluster@1.3.0/dist/leaflet.markercluster.js'></script>
		<script type="text/javascript">
			// On initialise la latitude et la longitude de Paris (centre de la carte)
			var lat = 48.852969;
			var lon = 2.349903;
			var macarte = null;
            var markerClusters; // Servira à stocker les groupes de marqueurs
            // Nous initialisons une liste de marqueurs
            var villes = {
                "Paris": { "lat": 48.852969, "lon": 2.349903 },
                "Brest": { "lat": 48.383, "lon": -4.500 },
                "Quimper": { "lat": 48.000, "lon": -4.100 },
                "Bayonne": { "lat": 43.500, "lon": -1.467 }
            };
			// Fonction d'initialisation de la carte
   			function initMap() {
                // Nous définissons le dossier qui contiendra les marqueurs
                var iconBase = 'http://localhost/carte/icons/';
				// Créer l'objet "macarte" et l'insèrer dans l'élément HTML qui a l'ID "map"
                macarte = L.map('map').setView([lat, lon], 11);
                markerClusters = L.markerClusterGroup(); // Nous initialisons les groupes de marqueurs
                // Leaflet ne récupère pas les cartes (tiles) sur un serveur par défaut. Nous devons lui préciser où nous souhaitons les récupérer. Ici, openstreetmap.fr
                L.tileLayer('https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png', {
                    // Il est toujours bien de laisser le lien vers la source des données
                    attribution: 'données © <a href="//osm.org/copyright">OpenStreetMap</a>/ODbL - rendu <a href="//openstreetmap.fr">OSM France</a>',
                    minZoom: 1,
                    maxZoom: 20
                }).addTo(macarte);
                // Nous parcourons la liste des villes
                for (ville in villes) {
	                // Nous définissons l'icône à utiliser pour le marqueur, sa taille affichée (iconSize), sa position (iconAnchor) et le décalage de son ancrage (popupAnchor)
                    var myIcon = L.icon({
                        iconUrl: iconBase + "autres.png",
                        iconSize: [50, 50],
                        iconAnchor: [25, 50],
                        popupAnchor: [-3, -76],
                    });
                    var marker = L.marker([villes[ville].lat, villes[ville].lon], { icon: myIcon }); // pas de addTo(macarte), l'affichage sera géré par la bibliothèque des clusters
                    marker.bindPopup(ville);
                    markerClusters.addLayer(marker); // Nous ajoutons le marqueur aux groupes
                }
                macarte.addLayer(markerClusters);
            }
			window.onload = function(){
				// Fonction d'initialisation qui s'exécute lorsque le DOM est chargé
				initMap(); 
			};
		</script>
		<style type="text/css">
			#map{ /* la carte DOIT avoir une hauteur sinon elle n'apparaît pas */
				height:400px;
			}
		</style>
		<title>Carte</title>
	</head>
	<body>
		<div id="map">
			<!-- Ici s'affichera la carte -->
		</div>
	</body>
</html>

Adapter le zoom pour afficher tous les marqueurs

Il pourra être nécessaire, ponctuellement, d’adapter le zoom de la carte pour afficher automatiquement tous les marqueurs.

L’approche est simple, regrouper tous les marqueurs dans un tableau et demander à ce que le zoom s’adapte pour qu’ils soient tous visibles.

Voici le code de la fonction initMap finalisée

function initMap() {
	var markers = []; // Nous initialisons la liste des marqueurs
	// Nous définissons le dossier qui contiendra les marqueurs
	var iconBase = 'http://localhost/carte/icons/';
	// Créer l'objet "macarte" et l'insèrer dans l'élément HTML qui a l'ID "map"
	macarte = L.map('map').setView([lat, lon], 11);
	markerClusters = L.markerClusterGroup(); // Nous initialisons les groupes de marqueurs
	// Leaflet ne récupère pas les cartes (tiles) sur un serveur par défaut. Nous devons lui préciser où nous souhaitons les récupérer. Ici, openstreetmap.fr
	L.tileLayer('https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png', {
		// Il est toujours bien de laisser le lien vers la source des données
		attribution: 'données © OpenStreetMap/ODbL - rendu OSM France',
		minZoom: 1,
		maxZoom: 20
	}).addTo(macarte);
	// Nous parcourons la liste des villes
	for (ville in villes) {
		// Nous définissons l'icône à utiliser pour le marqueur, sa taille affichée (iconSize), sa position (iconAnchor) et le décalage de son ancrage (popupAnchor)
		var myIcon = L.icon({
			iconUrl: iconBase + "autres.png",
			iconSize: [50, 50],
			iconAnchor: [25, 50],
			popupAnchor: [-3, -76],
		});
		var marker = L.marker([villes[ville].lat, villes[ville].lon], { icon: myIcon }); // pas de addTo(macarte), l'affichage sera géré par la bibliothèque des clusters
		marker.bindPopup(ville);
		markerClusters.addLayer(marker); // Nous ajoutons le marqueur aux groupes
		markers.push(marker); // Nous ajoutons le marqueur à la liste des marqueurs
	}
	var group = new L.featureGroup(markers); // Nous créons le groupe des marqueurs pour adapter le zoom
	macarte.fitBounds(group.getBounds().pad(0.5)); // Nous demandons à ce que tous les marqueurs soient visibles, et ajoutons un padding (pad(0.5)) pour que les marqueurs ne soient pas coupés
	macarte.addLayer(markerClusters);
}

Voilà, bon amusement

Commentaires

Ecrire un commentaire

ACAB a écrit le 25 novembre 2018 à 09:11

Bonjour,

Merci pour ce tuto très clair. J'aurais cependant une question:

Comment insérer un tracé entre deux points sur la carte? Pour visualiser l'itinéraire?

Merci

Répondre

Xavier a écrit le 22 novembre 2018 à 21:11

Génial, 

après plusieurs recherches infructeuses, ce tuto m'éclaire !

Est-il possible d'ajouter des marqueurs à partir d'une base de données ?

Merci

Répondre

Nouvelle-Techno.fr a répondu le 22 novembre 2018 à 22:11

Bonjour,

Merci pour vos encouragements.

Il est tout à fait possible d'afficher les marqueurs à partir d'une base de données, les informations étant envoyées sous forme de tableau.

Les données viendront remplacer celles de la variable villes dans le code exemple.

Répondre

Marc a écrit le 30 octobre 2018 à 16:10

Bonjour,

Merci pour ce tuto qui m'a permis de démarrer mon projet OpenStreetMap.

Pour allez plus loin, j'ai comme objectif de changer l'icon d'un marqueur sur une action externe à la carte (passage sur une div qui contient de l'info associée à ce marqueur). Pour cela je pensais utiliser la méthode "setIcon" de l'objet Marker, mais actuellemnt ça plante en me retournant dans la console le message d'erreur : " t.icon.createIcon is not a function " généré par le fichier leaftleft.js. Avez-vous une piste à ce sujet ?

Cordialment.
Marc

Répondre

Florent a écrit le 30 octobre 2018 à 11:10

Bonjour,

Merci pour le tuto très clair.

Peut-on changer le Layer (style de carte) ?

Merci

Répondre

Florent a répondu le 31 octobre 2018 à 15:10

Merci beaucoup !

Répondre

Marcus a écrit le 19 octobre 2018 à 00:10

Wow!!! Vous n'imaginez même pas l'aide que vous venez de m'apporter !

Merci infiniment.......

Répondre

Nouvelle-Techno.fr a répondu le 19 octobre 2018 à 07:10

Merci à vous.

Répondre

Amiral a écrit le 11 octobre 2018 à 18:10

Excellent article, très complet et explicite.

Répondre

Nouvelle-Techno.fr a répondu le 11 octobre 2018 à 21:10

Merci beaucoup Amiral

Répondre

MrFreeman a écrit le 05 octobre 2018 à 14:10

Bonjour,

Je vous remercie pour votre tuto, j'aurais 2 questions :

1. Dans votre tuto est utilisé les positions gps (lat, long), mais est il possible d' utiliser les codes postaux + ville à la place?

2. Savez-vous si l'on peux utiliser des adresse stockés dans une bases de données sql. Ce serait pour créer une carte avec un code postal + ville rentrée et des adresses d entreprises proches du lieux indiqué.

Merci.

 

 

Répondre

Nouvelle-Techno.fr a répondu le 05 octobre 2018 à 15:10

Bonjour,

Tout celà est tout à fait possible en utilisant le service nominatim d'OpenStreetMap.

Vous le trouverez à l'adresse https://nominatim.openstreetmap.org

Répondre

MrFreeman a répondu le 19 octobre 2018 à 08:10

Bonjour,

Tout celà est tout à fait possible en utilisant le service nominatim d'OpenStreetMap.

Vous le trouverez à l'adresse https://nominatim.openstreetmap.org

Merci pour votre réponse et désolé de mon retour tardif. Comme je vous l'expliquais je cherche à repmlacer une fonction qui utilise Google Maps.

$destination1 =  $code_postal_sinistre.' '.$ville_choisi.', france';
$destination2 =  $tab2['codepostal'].' '.$tab2['ville'].', france';
//echo $destination1.' --- '.$destination2.'<BR>';
$dist = getDistance($destination2,$destination1);

function getDistance($adresse1,$adresse2)
{    
    $adresse1 = str_replace(" ", "+", $adresse1);
        $adresse2 = str_replace(" ", "+", $adresse2);
        $url='http://maps.google.fr/maps/api/directions/xml?language=fr&origin='.$adresse1.'&destination='.$adresse2.'&sensor=false';
    $xml=file_get_contents($url);
    $root = simplexml_load_string($xml);

    $distance=$root->route->leg->distance->value;
    
    if ($root->status == "OK")
    {
        return $distance;
    }
    else
    {        
        return "0";            
    }

}   

Le souci est que je ne vois pas comment la modifier pour utiliser, quelqu'un aurait il une idées. Mon programme calcul la distance entre un point A et different adresse réferencer dans une table sql, le tout afficher dans une tableau.

Merci de votre aide.

Répondre

BlueBear a écrit le 02 octobre 2018 à 22:10

Bravo pour ce tutoriel, vous m'avez beaucoup aidé et je vous en suis très reconnaissant.

Tout est très clair et compréhensible.

Merci à vous !

Répondre

Nouvelle-Techno.fr a répondu le 03 octobre 2018 à 09:10

Je vous en prie, c'est avec plaisir

Répondre

matias a écrit le 07 septembre 2018 à 16:09

Bonjour,

tout d'abord, merci pour votre travail, c'est top !

Je cherche en vain le moyen de desactiver le zoom avec la souris (scrollWheelZoom) auriez vous la solution s'il vous plait ?

Merci encore pour ce super article.

Bien cordialement

Répondre

Nouvelle-Techno.fr a répondu le 07 septembre 2018 à 16:09

Bonjour,

Merci pour vos encouragements.

Pour le zoom, en partant du principe que la carte est sur une variable mymap, le code à insérer est

mymap.scrollWheelZoom.disable();

 

Répondre

Letroisg a écrit le 18 août 2018 à 18:08

Très bonne alternative gratuite pour contourner le futur paiement de google-maps. J'ai pu adapter ce code à mon site de photos et cela fonctionne très bien.

Juste une petite question, pour les groupements de marqueurs, est-il possible de changer la courleur : le vert sur un fond de carte vert est trop peu visible ?

Bravo encore pour le(s) développeur(s) de ce tutoriel.

Répondre

Nouvelle-Techno.fr a répondu le 18 août 2018 à 19:08

Bonjour,

Merci pour ces encouragements.

Oui, les clusters sont mis en forme par CSS, il suffira donc de surcharger les classes correspondantes. Une petite analyse du code (par clic droit et examiner ou inspecter sur le cluster) devrait permettre d'y parvenir.

Répondre

Laisser un commentaire