Class Geocoder

โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์

ช่วยให้แปลงระหว่างที่อยู่กับพิกัดทางภูมิศาสตร์ได้
ตัวอย่างด้านล่างแสดงวิธีใช้ชั้นเรียนนี้ค้นหารายการที่ตรงกัน 9 อันดับแรกสำหรับสถานที่นี้ "ถนนหลัก" ในโคโลราโด เพิ่มข้อมูลเหล่านั้นลงในแผนที่ แล้วฝังไว้ใน Google เอกสารใหม่ 

// 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'));

ดูเพิ่มเติม

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
geocode(address)Objectรับตำแหน่งทางภูมิศาสตร์โดยประมาณสำหรับที่อยู่ที่ระบุ
reverseGeocode(latitude, longitude)Objectรับที่อยู่โดยประมาณสำหรับจุดทางภูมิศาสตร์ที่ระบุ
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)Geocoderกำหนดขอบเขตของพื้นที่ที่ควรให้ความสำคัญเป็นพิเศษในผลลัพธ์
setLanguage(language)Geocoderตั้งค่าภาษาที่จะใช้ในผลลัพธ์
setRegion(region)Geocoderตั้งค่าภูมิภาคที่จะใช้เมื่อแปลความหมายชื่อตำแหน่ง

เอกสารโดยละเอียด

geocode(address)

รับตำแหน่งทางภูมิศาสตร์โดยประมาณสำหรับที่อยู่ที่ระบุ 

// 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);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
addressStringที่อยู่

รีเทิร์น

Object — ออบเจ็กต์ JSON ที่มีข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์ ตามที่อธิบายไว้ที่นี่

reverseGeocode(latitude, longitude)

รับที่อยู่โดยประมาณสำหรับจุดทางภูมิศาสตร์ที่ระบุ 

// 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);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
latitudeNumberละติจูดของจุด
longitudeNumberลองจิจูดของจุด

รีเทิร์น

Object — ออบเจ็กต์ JSON ที่มีข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับตามที่อธิบายไว้ที่นี่

ดูเพิ่มเติม

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

กำหนดขอบเขตของพื้นที่ที่ควรให้ความสำคัญเป็นพิเศษในผลลัพธ์ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
swLatitudeNumberละติจูดของมุมตะวันตกเฉียงใต้ของเส้นแบ่ง
swLongitudeNumberลองจิจูดของมุมตะวันตกเฉียงใต้ของเส้นแบ่ง
neLatitudeNumberละติจูดของมุมตะวันออกเฉียงเหนือของเส้นแบ่ง
neLongitudeNumberลองจิจูดของมุมตะวันออกเฉียงเหนือของเส้นแบ่ง

รีเทิร์น

Geocoder — ออบเจ็กต์ Geocoder ที่ช่วยอำนวยความสะดวกในการเชื่อมโยงการเรียก

ดูเพิ่มเติม

setLanguage(language)

ตั้งค่าภาษาที่จะใช้ในผลลัพธ์ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
languageStringตัวระบุภาษา BCP-47

รีเทิร์น

Geocoder — ออบเจ็กต์ Geocoder ที่ช่วยอำนวยความสะดวกในการเชื่อมโยงการโทร

ดูเพิ่มเติม

setRegion(region)

ตั้งค่าภูมิภาคที่จะใช้เมื่อแปลความหมายชื่อตำแหน่ง รหัสภูมิภาคที่รองรับสอดคล้องกับ ccTLD ที่ Google Maps รองรับ เช่น รหัสภูมิภาค "uk" สอดคล้องกับ "maps.google.co.uk" 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
regionStringรหัสภูมิภาคที่จะใช้

รีเทิร์น

Geocoder — ออบเจ็กต์ Geocoder เพื่อช่วยอำนวยความสะดวกในการเชื่อมโยงการโทร

ดูเพิ่มเติม