Tester la position d'un point par rapport à un Polygone ou une Polyline

google.maps.geometry.poly

La bibliothèque google.maps.geometry contient un espace de nommage appelé poly : google.maps.geometry.poly. Celui-ci contient des fonctions utilitaires permettant de connaître la position d'un point par rapport à un polygone ou une polyline. Deux méthodes sont disponibles :

• containsLocation(point, polygone),
• isLocationOnEdge(point, polygone|polyline, tolérance).

Attention : pour utiliser ces méthodes, n'oubliez pas d'ajouter la bibliothèque geometry dans l'appel du script de l'API Google Maps v3 :

<script async defer src="https://maps.googleapis.com/maps/api/js?key=InsérezVotreCléApiGoogleMapsIci&libraries=geometry&callback=initialisation"></script>

Tester si un point est situé à l'intérieur ou l'extérieur d'un polygone - containsLocation

La méthode containsLocation permet de tester si un point, sous la forme d'un objet LatLng, est situé dans ou hors d'un polygone.

la méthode containsLocation attend deux paramètres :

• point (objet LatLng) : point dont on veut tester ou vérifier la présence dans le polygone,
• polygone (objet Polygon) : Polygone sur lequel est effectué le test.

• true : si le point est situé à l'intérieur du polygone,
• false : si le point est situé à l'extérieur du polygone.

Le code ci-dessous permet de savoir si le point cliqué sur la carte est situé à l'intérieur ou à l'extérieur du polygone :

function initialisation(){
	var optionsCarte = {
		zoom: 8,
		center: new google.maps.LatLng(47.389982, 0.688877)
	}
	var tableauDeLatLng = [
		new google.maps.LatLng( 47.406830, 0.649909 ),
		new google.maps.LatLng( 47.406830, 0.745525 ),
		new google.maps.LatLng( 47.390330, 0.736255 ),
		new google.maps.LatLng( 47.367547, 0.689391 ),
		new google.maps.LatLng( 47.383822, 0.660037 )
	];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte"), optionsCarte );
	
	var monPolygone = new google.maps.Polygon( { paths:tableauDeLatLng } );
	
	google.maps.event.addListener( maCarte, "click", function( evenement ) {
		if ( google.maps.geometry.poly.containsLocation( evenement.latLng, monPolygone ) ) {
			alert("Le point cliqué est situé à l'intérieur du polygone");
		} else {
			alert("Le point cliqué est situé à l'extérieur du polygone");
		}
	});
}

Les classes Map et Polygon héritant de la classe MVCObject voici une autre écriture possible :

function initialisation(){
	var tableauDeLatLng = [
		{ lat: 47.406830, lng: 0.649909 },
		{ lat: 47.406830, lng: 0.745525 },
		{ lat: 47.390330, lng: 0.736255 },
		{ lat: 47.367547, lng: 0.689391 },
		{ lat: 47.383822, lng: 0.660037 }
	];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte") );
		maCarte.setValues({
			zoom: 8,
			center: { lat: 47.389982, lng: 0.688877 }
		});

	var monPolygone = new google.maps.Polygon();
		monPolygone.set("paths", tableauDeLatLng);	

	maCarte.addListener( "click", function( evenement ) {
		if ( google.maps.geometry.poly.containsLocation( evenement.latLng, monPolygone ) ) {
			alert("Le point cliqué est situé à l'intérieur du polygone");
		} else {
			alert("Le point cliqué est situé à l'extérieur du polygone");
		}
	});
}

Vous pouvez voir un tutoriel et un exemple complet ici : Tester si un marqueur est situé à l'intérieur ou à l'extérieur d'un polygone

Tester la position d'un point par rapport à un polygone ou une polyline avec isLocationOnEdge

La méthode isLocationOnEdge(point, polygone|polyline, tolérance) permet de tester ou vérifier si un point, sous la forme d'un objet LatLng, est situé sur ou à proximité du périmètre d'un polygone ou d'une polyline, avec une certaine tolérance.

La méthode isLocationOnEdge(point, polygone|polyline, tolérance) attend trois paramètres :

• point (objet LatLng) : point dont on veut tester la présence sur ou à proximité d'une polyline ou, sur ou à proximité du bord d'un polygone,
• polygone|polyline (objet Polygon ou Polyline) : Polygone ou Polyline sur lequel ou laquelle est effectué le test.
• tolerance (en degrès) : la tolérance est un angle exprimé en degrès. Par défaut, la tolérance vaut 10^-9 degrès.

La valeur retournée est un booléen :

• true : le point est alors situé sur ou à proximité du polyline, ou le point est situé sur ou à proximité de la bordure du polygone,
• false : le point n'est pas situé sur ou à proximité du polyline, ou le point n'est pas situé sur ou à proximité de la bordure du polygone.

Tester la position d'un point par rapport au périmètre d'un polygone avec isLocationOnEdge

Le code ci-dessous permet de savoir si le point cliqué sur la carte est situé sur ou à proximité de la bordure du polygone :

function initialisation(){
	var tolerance = 0.006;
	var optionsCarte = {
		zoom: 8,
		center: new google.maps.LatLng(47.389982, 0.688877)
	};
	var tableauDeLatLng = [
		new google.maps.LatLng( 47.406830, 0.649909 ),
		new google.maps.LatLng( 47.406830, 0.745525 ),
		new google.maps.LatLng( 47.390330, 0.736255 ),
		new google.maps.LatLng( 47.367547, 0.689391 ),
		new google.maps.LatLng( 47.383822, 0.660037 )
	];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte"), optionsCarte );

	var monPolygone = new google.maps.Polygon( { paths:tableauDeLatLng } );

	google.maps.event.addListener( maCarte, "click", function( evenement ) {
		if ( google.maps.geometry.poly.isLocationOnEdge( evenement.latLng, monPolygone, tolerance ) ) {
			alert("Le point cliqué est situé sur ou à proximité de la bordure du polygone");
		} else {
			alert("Le point cliqué n'est pas situé sur ou à proximité de la bordure du polygone");
		}
	});
}

Les classes Map et Polygon héritant de la classe MVCObject voici une autre écriture possible :

function initialisation(){
	var tolerance = 0.006,
		tableauDeLatLng = [
			{ lat: 47.406830, lng: 0.649909 },
			{ lat: 47.406830, lng: 0.745525 },
			{ lat: 47.390330, lng: 0.736255 },
			{ lat: 47.367547, lng: 0.689391 },
			{ lat: 47.383822, lng: 0.660037 }
		];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte") );
		maCarte.setValues({
			zoom: 8,
			center: {lat: 47.389982, lng: 0.688877 }
		});

	var monPolygone = new google.maps.Polygon();
		monPolygone.set( "paths", tableauDeLatLng );

	maCarte.addListener( "click", function( evenement ) {
		if ( google.maps.geometry.poly.isLocationOnEdge( evenement.latLng, monPolygone, tolerance ) ) {
			alert("Le point cliqué est situé sur ou à proximité de la bordure du polygone");
		} else {
			alert("Le point cliqué n'est pas situé sur ou à proximité de la bordure du polygone");
		}
	});
}

Vous pouvez voir un tutoriel et un exemple complet ici : Tester si un marqueur est situé sur ou à proximité du périmètre d'un polygone.

Tester la position d'un point par rapport à une polyline avec isLocationOnEdge

Le code ci-dessous permet de savoir si le point cliqué est situé sur ou à proximité de la polyline :

function initialisation(){
	var tolerance = 0.006;
	var optionsCarte = {
		zoom: 8,
		center: new google.maps.LatLng(47.389982, 0.688877)
	};
	var tableauDeLatLng = [
		new google.maps.LatLng( 47.406830, 0.649909 ),
		new google.maps.LatLng( 47.406830, 0.745525 ),
		new google.maps.LatLng( 47.390330, 0.736255 ),
		new google.maps.LatLng( 47.367547, 0.689391 ),
		new google.maps.LatLng( 47.383822, 0.660037 )
	];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte"), optionsCarte );

	var maPolyline = new google.maps.Polyline( { path: tableauDeLatLng } );

	google.maps.event.addListener( maCarte, "click", function( evenement ) {
		if ( google.maps.geometry.poly.isLocationOnEdge( evenement.latLng, maPolyline, tolerance ) ) {
			alert("Le point cliqué est situé sur ou à proximité de la polyline");
		} else {
			alert("Le point cliqué n'est pas situé sur ou à proximité de la polyline");
		}
	});
}

Les classes Map et Polyline héritant de la classe MVCObject voici une autre écriture possible :

function initialisation(){
	var tolerance = 0.006,
		tableauDeLatLng = [
			{ lat: 47.406830, lng: 0.649909 },
			{ lat: 47.406830, lng: 0.745525 },
			{ lat: 47.390330, lng: 0.736255 },
			{ lat: 47.367547, lng: 0.689391 },
			{ lat: 47.383822, lng: 0.660037 }
		];

	var maCarte = new google.maps.Map( document.getElementById("EmplacementDeMaCarte") );
		maCarte.setValues({
			zoom: 8,
			center: {lat: 47.389982, lng: 0.688877 }
		});

	var maPolyline = new google.maps.Polyline();
		maPolyline.set( "path", tableauDeLatLng );
		
	maCarte.addListener( "click", function( evenement ) {
		if ( google.maps.geometry.poly.isLocationOnEdge( evenement.latLng, maPolyline, tolerance ) ) {
			alert("Le point cliqué est situé sur ou à proximité de la polyline");
		} else {
			alert("Le point cliqué n'est pas situé sur ou à proximité de la polyline");
		}
	});
}

Vous pouvez voir un tutoriel et un exemple complet ici : Tester si un marqueur est situé sur ou à proximité d'une polyline.