Class Geocoder

Geocoder

Cho phép chuyển đổi giữa địa chỉ và toạ độ địa lý.
Ví dụ bên dưới cho thấy cách bạn có thể sử dụng lớp này để tìm 9 kết quả trùng khớp hàng đầu cho vị trí "Main St" ở Colorado, thêm các kết quả đó vào bản đồ rồi nhúng bản đồ vào một tài liệu mới trên 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'));

Xem thêm

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
geocode(address)ObjectLấy các điểm địa lý gần đúng cho một địa chỉ nhất định.
reverseGeocode(latitude, longitude)ObjectLấy địa chỉ gần đúng cho một điểm địa lý nhất định.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderĐặt ranh giới của một khu vực cần được ưu tiên hơn trong kết quả.
setLanguage(language)GeocoderĐặt ngôn ngữ sẽ được sử dụng trong kết quả.
setRegion(region)GeocoderĐặt một khu vực để sử dụng khi diễn giải tên vị trí.

Tài liệu chi tiết

geocode(address)

Lấy các điểm địa lý gần đúng cho một địa chỉ nhất định. 

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

Thông số

TênLoạiMô tả
addressStringMột địa chỉ.

Cầu thủ trả bóng

Object – Một đối tượng JSON chứa dữ liệu mã hoá địa lý, như mô tả tại đây.

reverseGeocode(latitude, longitude)

Lấy địa chỉ gần đúng cho một điểm địa lý nhất định. 

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

Thông số

TênLoạiMô tả
latitudeNumberVĩ độ của điểm.
longitudeNumberKinh độ của điểm.

Cầu thủ trả bóng

Object – Một đối tượng JSON chứa dữ liệu mã hoá địa lý ngược, như mô tả tại đây.

Xem thêm

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Đặt ranh giới của một khu vực cần được ưu tiên hơn trong kết quả. 

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

Thông số

TênLoạiMô tả
swLatitudeNumberVĩ độ của góc dưới cùng bên trái của ranh giới.
swLongitudeNumberKinh độ của góc tây nam của ranh giới.
neLatitudeNumberVĩ độ của góc Đông Bắc của ranh giới.
neLongitudeNumberKinh độ của góc đông bắc của ranh giới.

Cầu thủ trả bóng

Geocoder – Đối tượng Geocoder để tạo điều kiện cho việc tạo chuỗi các lệnh gọi.

Xem thêm

setLanguage(language)

Đặt ngôn ngữ sẽ được sử dụng trong kết quả. 

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

Thông số

TênLoạiMô tả
languageStringGiá trị nhận dạng ngôn ngữ BCP-47.

Cầu thủ trả bóng

Geocoder – Đối tượng Geocoder để hỗ trợ việc tạo chuỗi các lệnh gọi.

Xem thêm

setRegion(region)

Đặt một khu vực để sử dụng khi diễn giải tên vị trí. Mã vùng được hỗ trợ tương ứng với ccTLD mà Google Maps hỗ trợ. Ví dụ: mã khu vực "uk" tương ứng với "maps.google.co.uk". 

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

Thông số

TênLoạiMô tả
regionStringMã khu vực cần sử dụng.

Cầu thủ trả bóng

Geocoder – Đối tượng Geocoder để hỗ trợ việc tạo chuỗi các lệnh gọi.

Xem thêm