Class Geocoder

Geocoder

Memungkinkan konversi antara alamat dan koordinat geografis.
Contoh di bawah menunjukkan cara menggunakan class ini untuk menemukan sembilan pencocokan teratas untuk lokasi "Main St" di Colorado, menambahkannya ke peta, lalu menyematkannya di Dokumen Google baru.

// Find the best matches for "Main St" in Colorado.
const 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.
const doc = DocumentApp.create('My Map');
const map = Maps.newStaticMap();

// Add each result to the map and doc.
for (let i = 0; i < response.results.length && i < 9; i++) {
  const 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'));

Lihat juga

• Google Geocoding API

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
geocode(address)	Object	Mendapatkan perkiraan titik geografis untuk alamat tertentu.
reverseGeocode(latitude, longitude)	Object	Mendapatkan perkiraan alamat untuk titik geografis tertentu.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Menetapkan batas area yang harus diberi preferensi tambahan dalam hasil.
setLanguage(language)	Geocoder	Menetapkan bahasa yang akan digunakan dalam hasil.
setRegion(region)	Geocoder	Menetapkan wilayah yang akan digunakan saat menafsirkan nama lokasi.

Dokumentasi mendetail

geocode(address)

Mendapatkan perkiraan titik geografis untuk alamat tertentu.

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

Parameter

Nama	Jenis	Deskripsi
address	String	alamat

Pulang pergi

Object — Objek JSON yang berisi data geocoding, seperti yang dijelaskan di sini

---

reverseGeocode(latitude, longitude)

Mendapatkan perkiraan alamat untuk titik geografis tertentu.

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

Parameter

Nama	Jenis	Deskripsi
latitude	Number	lintang titik
longitude	Number	bujur titik

Pulang pergi

Object — Objek JSON yang berisi data geocoding terbalik, seperti yang dijelaskan di sini

Lihat juga

• Google Geocoding API

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Menetapkan batas area yang harus diberi preferensi tambahan dalam hasil.

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

Parameter

Nama	Jenis	Deskripsi
swLatitude	Number	lintang sudut barat daya batas
swLongitude	Number	bujur sudut barat daya batas
neLatitude	Number	lintang sudut timur laut batas
neLongitude	Number	bujur sudut timur laut batas

Pulang pergi

Geocoder — objek Geocoder untuk memfasilitasi pembuatan rantai panggilan

Lihat juga

• Google Geocoding API

---

setLanguage(language)

Menetapkan bahasa yang akan digunakan dalam hasil.

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

Parameter

Nama	Jenis	Deskripsi
language	String	ID bahasa BCP-47

Pulang pergi

Geocoder — objek Geocoder untuk memfasilitasi pembuatan rantai panggilan.

Lihat juga

• Format Polyline yang Dienkode

---

setRegion(region)

Menetapkan wilayah yang akan digunakan saat menafsirkan nama lokasi. Kode wilayah yang didukung sesuai dengan ccTLD yang didukung oleh Google Maps. Misalnya, kode wilayah "uk" sesuai dengan "maps.google.co.uk".

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

Parameter

Nama	Jenis	Deskripsi
region	String	kode wilayah yang akan digunakan

Pulang pergi

Geocoder — objek Geocoder untuk memfasilitasi pembuatan rantai panggilan

Lihat juga

• Google Geocoding API