Class Geocoder

Geocoder (קואורדינטות)

מאפשרת לבצע המרה בין כתובת לקואורדינטות גיאוגרפיות.
הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו במציאת תשע ההתאמות המובילות למיקום "הרחוב הראשי" בקולורדו, תוכלו להוסיף אותם למפה ואז להטמיע אותם במסמך חדש ב-Google Docs. 

// 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. לדוגמה, קידומת האזור "uk" תואם ל- 'maps.google.co.uk'. 

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

פרמטרים

שםסוגתיאור
regionStringקוד האזור שבו צריך להשתמש

חזרה

Geocoder – האובייקט Geocoder כדי לאפשר שרשור של קריאות

ראה גם