Class Geocoder

Geocoder

Permet de convertir une adresse en coordonnées géographiques.
L'exemple ci-dessous montre comment utiliser cette classe pour rechercher les neuf meilleures correspondances pour l'emplacement "Main St" dans le Colorado, les ajouter à une carte, puis l'intégrer dans un nouveau document Google Docs.

// Find the best matches for "Main St" in Colorado.
var response = Maps.newGeocoder()
    // The latitudes and longitudes of southwest and northeast corners of Colorado, respectively.
    .setBounds(36.998166, -109.045486, 41.001666,-102.052002)
    .geocode('Main St');

// Create a Google Doc and map.
var doc = DocumentApp.create('My Map');
var map = Maps.newStaticMap();

// Add each result to the map and doc.
for (var i = 0; i < response.results.length && i < 9; i++) {
  var result = response.results[i];
  map.setMarkerStyle(null, null, i + 1);
  map.addMarker(result.geometry.location.lat, result.geometry.location.lng);
  doc.appendListItem(result.formatted_address);
}

// Add the finished map to the doc.
doc.appendImage(Utilities.newBlob(map.getMapImage(), 'image/png'));

Voir aussi

Méthodes

MéthodeType renvoyéBrève description
geocode(address)ObjectRécupère les points géographiques approximatifs d'une adresse donnée.
reverseGeocode(latitude, longitude)ObjectRécupère les adresses approximatives d'un point géographique donné.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDéfinit les limites d'une zone à laquelle accorder une préférence supplémentaire dans les résultats.
setLanguage(language)GeocoderDéfinit la langue à utiliser dans les résultats.
setRegion(region)GeocoderDéfinit une région à utiliser lors de l'interprétation des noms de lieux.

Documentation détaillée

geocode(address)

Récupère les points géographiques approximatifs d'une adresse donnée.

// Gets the geographic coordinates for Times Square.
var response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (var i = 0; i < response.results.length; i++) {
  var result = response.results[i];
  Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat,
      result.geometry.location.lng);
}

Paramètres

NomTypeDescription
addressStringune adresse

Renvois

Object : objet JSON contenant les données de geocoding, comme décrit ici.


reverseGeocode(latitude, longitude)

Récupère les adresses approximatives d'un point géographique donné.

// Gets the address of a point in Times Square.
var response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (var i = 0; i < response.results.length; i++) {
  var result = response.results[i];
  Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat,
      result.geometry.location.lng);
}

Paramètres

NomTypeDescription
latitudeNumberla latitude du point
longitudeNumberla longitude du point

Renvois

Object : objet JSON contenant les données de geocoding inversé, comme décrit ici.

Voir aussi


setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Définit les limites d'une zone à laquelle accorder une préférence supplémentaire dans les résultats.

// Creates a Geocoder that prefers points in the area of Manhattan.
var geocoder = Maps.newGeocoder()
    .setBounds(40.699642, -74.021072, 40.877569, -73.908548);

Paramètres

NomTypeDescription
swLatitudeNumberla latitude de l'angle sud-ouest de la limite
swLongitudeNumberla longitude de l'angle sud-ouest des limites
neLatitudeNumberla latitude de l'angle nord-est de la limite
neLongitudeNumberla longitude de l'angle nord-est de la limite ;

Renvois

Geocoder : objet Geocoder pour faciliter le chaînage d'appels.

Voir aussi


setLanguage(language)

Définit la langue à utiliser dans les résultats.

// Creates a Geocoder with the language set to French.
var geocoder = Maps.newGeocoder().setLanguage('fr');

Paramètres

NomTypeDescription
languageStringun identifiant de langue BCP-47

Renvois

Geocoder : objet Geocoder pour faciliter le chaînage d'appels.

Voir aussi


setRegion(region)

Définit une région à utiliser lors de l'interprétation des noms de lieux. Les codes des régions acceptés correspondent aux ccTLD pris en charge par Google Maps. Par exemple, le code de région "uk" correspond à "maps.google.co.uk".

// Creates a Geocoder with the region set to France.
var geocoder = Maps.newGeocoder().setRegion('fr');

Paramètres

NomTypeDescription
regionStringle code régional à utiliser

Renvois

Geocoder : objet Geocoder pour faciliter le chaînage d'appels.

Voir aussi