ช่วยให้แปลงที่อยู่เป็นพิกัดทางภูมิศาสตร์หรือแปลงพิกัดทางภูมิศาสตร์เป็นที่อยู่ได้
ตัวอย่างด้านล่างแสดงวิธีใช้คลาสนี้เพื่อค้นหาสถานที่ที่ตรงกันมากที่สุด 9 แห่งสำหรับ "Main St" ในโคโลราโด เพิ่มสถานที่เหล่านั้นลงในแผนที่ แล้วฝังลงใน Google เอกสารใหม่
// 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'));
ดูเพิ่มเติม
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
geocode(address) | Object | รับจุดทางภูมิศาสตร์โดยประมาณของที่อยู่หนึ่งๆ |
reverse | Object | รับที่อยู่โดยประมาณของจุดทางภูมิศาสตร์ที่ระบุ |
set | Geocoder | กำหนดขอบเขตของพื้นที่ที่ควรได้รับการพิจารณาเป็นพิเศษในผลการค้นหา |
set | Geocoder | ตั้งค่าภาษาที่จะใช้ในผลการค้นหา |
set | Geocoder | ตั้งค่าภูมิภาคที่จะใช้เมื่อตีความชื่อสถานที่ |
เอกสารประกอบโดยละเอียด
geocode(address)
รับจุดทางภูมิศาสตร์โดยประมาณของที่อยู่หนึ่งๆ
// 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,
);
}
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
address | String | ที่อยู่ |
รีเทิร์น
Object — ออบเจ็กต์ JSON ที่มีข้อมูลการแปลงพิกัดภูมิศาสตร์ตามที่อธิบายไว้ที่นี่
reverse
รับที่อยู่โดยประมาณของจุดทางภูมิศาสตร์ที่ระบุ
// 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,
);
}
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
latitude | Number | ละติจูดของจุด |
longitude | Number | ลองจิจูดของจุด |
รีเทิร์น
Object — ออบเจ็กต์ JSON ที่มีข้อมูลการแปลงพิกัดภูมิศาสตร์ย้อนกลับตามที่อธิบายไว้ที่นี่
ดูเพิ่มเติม
set
กำหนดขอบเขตของพื้นที่ที่ควรได้รับการพิจารณาเป็นพิเศษในผลการค้นหา
// Creates a Geocoder that prefers points in the area of Manhattan.
const geocoder = Maps.newGeocoder().setBounds(
40.699642,
-74.021072,
40.877569,
-73.908548,
);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
sw | Number | ละติจูดของมุมตะวันตกเฉียงใต้ของขอบเขต |
sw | Number | ลองจิจูดของมุมตะวันตกเฉียงใต้ของขอบเขต |
ne | Number | ละติจูดของมุมตะวันออกเฉียงเหนือของขอบเขต |
ne | Number | ลองจิจูดของมุมตะวันออกเฉียงเหนือของขอบเขต |
รีเทิร์น
Geocoder — ออบเจ็กต์ Geocoder เพื่อช่วยให้การเรียกใช้แบบต่อเนื่องง่ายขึ้น
ดูเพิ่มเติม
set
ตั้งค่าภาษาที่จะใช้ในผลการค้นหา
// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
language | String | ตัวระบุภาษา BCP-47 |
รีเทิร์น
Geocoder — ออบเจ็กต์ Geocoder เพื่อช่วยให้การเรียกใช้แบบต่อเนื่องง่ายขึ้น
ดูเพิ่มเติม
set
ตั้งค่าภูมิภาคที่จะใช้เมื่อตีความชื่อสถานที่ รหัสภูมิภาคที่รองรับจะสอดคล้องกับ ccTLD ที่ Google Maps รองรับ เช่น รหัสภูมิภาค "uk" สอดคล้องกับ "maps.google.co.uk"
// Creates a Geocoder with the region set to France.
const geocoder = Maps.newGeocoder().setRegion('fr');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
region | String | รหัสภูมิภาคที่จะใช้ |
รีเทิร์น
Geocoder — ออบเจ็กต์ Geocoder เพื่อช่วยให้การเรียกใช้แบบต่อเนื่องง่ายขึ้น