Cette page a été traduite par l'API Cloud Translation.

Class Geocoder

permet la conversion entre une adresse et des coordonnées géographiques.
L'exemple ci-dessous montre comment utiliser cette classe pour trouver les neuf meilleures correspondances pour le lieu "rue des fleurs" dans le Colorado, ajoutez-les à une carte, puis intégrez-la 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

API Google Geocoding

Méthodes

Méthode	Type renvoyé	Brève description
`geocode(address)`	`Object`	Récupère les points géographiques approximatifs pour une adresse donnée.
`reverseGeocode(latitude, longitude)`	`Object`	Récupère les adresses approximatives pour un point géographique donné.
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	Définit les limites d'une zone à laquelle une préférence supplémentaire doit être accordée dans les résultats.
`setLanguage(language)`	`Geocoder`	Définit la langue à utiliser dans les résultats.
`setRegion(region)`	`Geocoder`	Définit la 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 pour 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

Nom	Type	Description
`address`	`String`	une adresse

Renvois

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

`reverseGeocode(latitude, longitude)`

Récupère les adresses approximatives pour 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

Nom	Type	Description
`latitude`	`Number`	la latitude du point
`longitude`	`Number`	la longitude du point

Renvois

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

Voir aussi

API Google Geocoding

`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`

Définit les limites d'une zone à laquelle une préférence supplémentaire doit être accordée 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

Nom	Type	Description
`swLatitude`	`Number`	la latitude de l'angle sud-ouest des limites
`swLongitude`	`Number`	longitude de l'angle sud-ouest des limites
`neLatitude`	`Number`	latitude de l'angle nord-est des limites
`neLongitude`	`Number`	longitude de l'angle nord-est des limites

Renvois

Geocoder : objet Geocoder permettant de faciliter le chaînage d'appels

Voir aussi

API Google Geocoding

`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

Nom	Type	Description
`language`	`String`	un identifiant de langue BCP-47

Renvois

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

Voir aussi

Format des polylignes encodées

`setRegion(region)`

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

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

Paramètres

Nom	Type	Description
`region`	`String`	le code de région à utiliser

Renvois

Geocoder : objet Geocoder permettant de faciliter le chaînage d'appels

Voir aussi

API Google Geocoding