Class Geocoder

Trình mã hoá địa lý

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 ra 9 kết quả phù hợp nhất 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 Google Doc mới.

// 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ứcLoại 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 giới hạn 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ẽ 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,
  );
}

Tham số

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

Cầu thủ trả bóng

Object – Đối tượng JSON chứa dữ liệu địa chỉ, 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,
  );
}

Tham số

TênLoạiMô tả
latitudeNumbervĩ độ của điểm
longitudeNumberkinh độ của điểm

Cầu thủ trả bóng

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

Xem thêm


setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Đặt giới hạn 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,
);

Tham số

TênLoạiMô tả
swLatitudeNumbervĩ độ của góc tây nam 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 Trình định dạng địa lý để tạo chuỗi lệnh gọi

Xem thêm


setLanguage(language)

Đặt ngôn ngữ sẽ dùng trong kết quả.

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

Tham 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 Trình mã hoá địa lý để tạo điều kiện cho việc tạo chuỗi 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ã khu vực được hỗ trợ tương ứng với các 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');

Tham số

TênLoạiMô tả
regionStringmã vùng cần sử dụng

Cầu thủ trả bóng

Geocoder – đối tượng Trình định dạng địa lý để tạo chuỗi lệnh gọi

Xem thêm