Class ElevationSampler

ElevationSampler

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éthodeType renvoyéBrève description
sampleLocation(latitude, longitude)ObjectRenvoie les données d'altitude pour un point unique (lat/lng).
sampleLocations(points)ObjectRenvoie les données d'altitude pour une série de points (lat/lng).
sampleLocations(encodedPolyline)ObjectRenvoie les données d'altitude des points d'une polyligne encodée.
samplePath(points, numSamples)ObjectRenvoie 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)ObjectRenvoie 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

NomTypeDescription
latitudeNumberla latitude du point à échantillonner
longitudeNumberla 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

NomTypeDescription
pointsNumber[]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

NomTypeDescription
encodedPolylineStringune 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

NomTypeDescription
pointsNumber[]Tableau de paires latitude/longitude définissant un tracé sur lequel échantillonner
numSamplesIntegerle 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

NomTypeDescription
encodedPolylineStringune polyligne encodée de points définissant un tracé sur lequel échantillonner.
numSamplesIntegerle nombre de points à échantillonner le long du chemin des points.

Renvois

Object : objet JSON contenant les données d'altitude, comme décrit ici.