Class Geocoder

Geocoder

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

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

ראה גם

• Google Geocoding API

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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.
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 שמכיל את נתוני הגיאוקודינג, כפי שמתואר כאן

---

reverseGeocode(latitude, longitude)

הפונקציה מקבלת את הכתובות המשוערות של נקודה גיאוגרפית נתונה.

// 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 שמכיל את נתוני הגיאוקודינג ההפוך, כפי שמתואר כאן

ראה גם

• Google Geocoding API

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

הגדרת הגבולות של אזור שצריך לתת לו עדיפות נוספת בתוצאות.

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

פרמטרים

שם	סוג	תיאור
swLatitude	Number	קו הרוחב של הפינה הדרום-מערבית של הגבולות
swLongitude	Number	קו האורך של הפינה הדרום-מערבית של הגבולות
neLatitude	Number	קו הרוחב של הפינה הצפונית-מזרחית של הגבולות
neLongitude	Number	קו האורך של הפינה הצפונית-מזרחית של הגבולות

חזרה

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

ראה גם

• Google Geocoding API

---

setLanguage(language)

הגדרת השפה שבה יוצגו התוצאות.

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

פרמטרים

שם	סוג	תיאור
language	String	מזהה שפה לפי BCP-47

חזרה

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

ראה גם

• פורמט קו פוליגון קודד

---

setRegion(region)

הגדרת אזור לשימוש בזמן הפענוח של שמות המיקומים. קודי האזורים הנתמכים תואמים לדומיינים ברמה העליונה של המדינה (ccTLD) שנתמכים במפות Google. לדוגמה, קוד האזור 'uk' תואם לכתובת 'maps.google.co.uk'.

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

פרמטרים

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

חזרה

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

ראה גם

• Google Geocoding API