Permet l'échantillonnage des altitudes à des lieux particuliers.
L'exemple ci-dessous montre comment utiliser cette classe pour déterminer le point culminant de l'itinéraire entre Denver et Grand Junction, dans le Colorado, tracer le trajet sur une carte et l'enregistrer dans Google Drive.
// Get directions from Denver to Grand Junction. var directions = Maps.newDirectionFinder() .setOrigin('Denver, CO') .setDestination('Grand Junction, CO') .setMode(Maps.DirectionFinder.Mode.DRIVING) .getDirections(); var route = directions.routes[0]; // Get elevation samples along the route. var numberOfSamples = 30; var response = Maps.newElevationSampler() .samplePath(route.overview_polyline.points, numberOfSamples) // Determine highest point. var maxElevation = Number.MIN_VALUE; var highestPoint = null; for (var i = 0; i < response.results.length; i++) { var sample = response.results[i]; if (sample.elevation > maxElevation) { maxElevation = sample.elevation; highestPoint = sample.location; } } // Add the path and marker to a map. var map = Maps.newStaticMap() .addPath(route.overview_polyline.points) .addMarker(highestPoint.lat, highestPoint.lng); // Save the map to your drive DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));
Voir aussi
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
sampleLocation(latitude, longitude) | Object | Renvoie les données d'altitude pour un point unique (lat/lng). |
sampleLocations(points) | Object | Renvoie les données d'altitude pour une série de points (lat/lng). |
sampleLocations(encodedPolyline) | Object | Renvoie les données d'altitude des points d'une polyligne encodée. |
samplePath(points, numSamples) | Object | Renvoie les données d'altitude pour un certain nombre d'échantillons le long d'une ligne, définie à l'aide d'une série de points. |
samplePath(encodedPolyline, numSamples) | Object | Renvoie les données d'altitude pour un certain nombre d'échantillons le long d'une ligne, définie à l'aide d'une polyligne encodée. |
Documentation détaillée
sampleLocation(latitude, longitude)
Renvoie les données d'altitude pour un point unique (lat/lng).
// Gets the elevation of Times Square using a point. var data = Maps.newElevationSampler().sampleLocation(40.759011, -73.984472); Logger.log(data.results[0].elevation);
Paramètres
Nom | Type | Description |
---|---|---|
latitude | Number | la latitude du point à échantillonner |
longitude | Number | la longitude du point à échantillonner |
Renvois
Object
: objet JSON contenant les données d'altitude, comme décrit ici.
sampleLocations(points)
Renvoie les données d'altitude pour une série de points (lat/lng).
// Gets the elevation of Times Square and Central Park using points. var data = Maps.newElevationSampler().sampleLocations([ // Times Square 40.759011, -73.984472, // Central Park 40.777052, -73.975464 ]); Logger.log('Times Square: ' + data.results[0].elevation); Logger.log('Central Park: ' + data.results[1].elevation);
Paramètres
Nom | Type | Description |
---|---|---|
points | Number[] | un tableau de paires latitude/longitude |
Renvois
Object
: objet JSON contenant les données d'altitude, comme décrit ici.
sampleLocations(encodedPolyline)
Renvoie les données d'altitude des points d'une polyligne encodée.
// Gets the elevation of Times Square and Central Park using a polyline. var data = Maps.newElevationSampler().sampleLocations('yvwwF|aqbMwoBiw@'); Logger.log('Times Square: ' + data.results[0].elevation); Logger.log('Central Park: ' + data.results[1].elevation);
Paramètres
Nom | Type | Description |
---|---|---|
encodedPolyline | String | une polyligne encodée de points à échantillonner |
Renvois
Object
: objet JSON contenant les données d'altitude, comme décrit ici.
samplePath(points, numSamples)
Renvoie les données d'altitude pour un certain nombre d'échantillons le long d'une ligne, définie à l'aide d'une série de points.
// Gets the elevation of five points between Times Square and Central Park. var data = Maps.newElevationSampler().samplePath([ // Times Square 40.759011, -73.984472, // Central Park 40.777052, -73.975464 ], 5); for (var i = 0; i < data.results.length; i++) { Logger.log(data.results[i].elevation); }
Paramètres
Nom | Type | Description |
---|---|---|
points | Number[] | Tableau de paires latitude/longitude définissant un tracé sur lequel échantillonner |
numSamples | Integer | le nombre de points à échantillonner le long du chemin des points. |
Renvois
Object
: objet JSON contenant les données d'altitude, comme décrit ici.
samplePath(encodedPolyline, numSamples)
Renvoie les données d'altitude pour un certain nombre d'échantillons le long d'une ligne, définie à l'aide d'une polyligne encodée.
// Gets the elevation of five points between Times Square and Central Park. var data = Maps.newElevationSampler().samplePath('yvwwF|aqbMwoBiw@', 5); for (var i = 0; i < data.results.length; i++) { Logger.log(data.results[i].elevation); }
Paramètres
Nom | Type | Description |
---|---|---|
encodedPolyline | String | une polyligne encodée de points définissant un tracé sur lequel échantillonner. |
numSamples | Integer | le nombre de points à échantillonner le long du chemin des points. |
Renvois
Object
: objet JSON contenant les données d'altitude, comme décrit ici.