Class StaticMap

StaticMap

מאפשר יצירה ועיטור של תמונות מפה סטטיות.

הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו כדי ליצור מפה של תיאטרון תל אביב. מחוז, כולל תחנות רכבת קרובות, ולהציג אותו באפליקציית אינטרנט פשוטה.

// Create a map centered on Times Square.
var map = Maps.newStaticMap()
    .setSize(600, 600)
    .setCenter('Times Square, New York, NY');

// Add markers for the nearbye train stations.
map.setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T');
map.addMarker('Grand Central Station, New York, NY');
map.addMarker('Penn Station, New York, NY');

// Show the boundaries of the Theatre District.
var corners = [
  '8th Ave & 53rd St, New York, NY',
  '6th Ave & 53rd St, New York, NY',
  '6th Ave & 40th St, New York, NY',
  '8th Ave & 40th St, New York, NY'
];
map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE);
map.beginPath();
for (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

ראה גם

• API של מפות Google סטטי

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
addAddress(address)	StaticMap	הוספה של כתובת חדשה להגדרת הנתיב הנוכחית.
addMarker(latitude, longitude)	StaticMap	מוסיף סמן למפה באמצעות נקודה (קו רוחב/lng).
addMarker(address)	StaticMap	הוספת סמן למפה באמצעות כתובת.
addPath(points)	StaticMap	הוספת נתיב למפה באמצעות מערך של נקודות.
addPath(polyline)	StaticMap	הוספת נתיב למפה באמצעות קו פוליגוני מקודד.
addPoint(latitude, longitude)	StaticMap	הוספת נקודה חדשה (קו רוחב/lng) להגדרת הנתיב הנוכחית.
addVisible(latitude, longitude)	StaticMap	מוסיף מיקום של נקודה (קו רוחב/lng) שחייב להיות גלוי במפה.
addVisible(address)	StaticMap	הוספת מיקום כתובת שחייב להיות גלוי במפה.
beginPath()	StaticMap	התחלה של הגדרת נתיב חדשה.
clearMarkers()	StaticMap	ניקוי קבוצת הסמנים הנוכחית.
clearPaths()	StaticMap	ניקוי קבוצת הנתיבים הנוכחית.
clearVisibles()	StaticMap	ניקוי הקבוצה הנוכחית של המיקומים הגלויים.
endPath()	StaticMap	משלימה הגדרת נתיב שהתחילה ב-startPath().
getAs(contentType)	Blob	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
getBlob()	Blob	הפונקציה מקבלת את נתוני התמונה כ-Blob.
getMapImage()	Byte[]	מקבלת את נתוני התמונה הגולמיים כמערך בייטים.
getMapUrl()	String	הפונקציה מקבלת את כתובת ה-URL של תמונת המפה.
setCenter(latitude, longitude)	StaticMap	מגדיר את מרכז המפה באמצעות נקודה (קו רוחב/lng).
setCenter(address)	StaticMap	מגדיר את מרכז המפה באמצעות כתובת.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	מגדיר את תמונת הסמן המותאמת אישית לשימוש בעת יצירת סמנים חדשים.
setFormat(format)	StaticMap	מגדיר את הפורמט של תמונת המפה.
setLanguage(language)	StaticMap	הגדרת השפה לשימוש בטקסט במפה (היכן שזמין).
setMapType(mapType)	StaticMap	מגדיר את סוג המפה שתוצג.
setMarkerStyle(size, color, label)	StaticMap	הגדרת סגנון הסמן לשימוש במהלך יצירת סמנים חדשים.
setMobile(useMobileTiles)	StaticMap	המדיניות קובעת אם להשתמש בערכות משבצות מיוחדות למכשירים ניידים.
setPathStyle(weight, color, fillColor)	StaticMap	מגדיר את סגנון הנתיב שישמש ליצירת נתיבים חדשים.
setSize(width, height)	StaticMap	מגדיר את הרוחב והגובה של תמונת המפה בפיקסלים.
setZoom(zoom)	StaticMap	מגדיר את גורם הזום, או רמת ההגדלה, המשמשים במפה.

מסמכי תיעוד מפורטים

addAddress(address)

הוספה של כתובת חדשה להגדרת הנתיב הנוכחית.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

פרמטרים

שם	סוג	תיאור
address	String	כתובת להוספה.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

addMarker(latitude, longitude)

מוסיף סמן למפה באמצעות נקודה (קו רוחב/lng).

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הסמן החדש.
longitude	Number	קו האורך של הסמן החדש.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

addMarker(address)

הוספת סמן למפה באמצעות כתובת.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

פרמטרים

שם	סוג	תיאור
address	String	הכתובת בוויץ' לצורך מיקום הסמן החדש.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

addPath(points)

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

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .addPath([40.714353, -74.005973, 42.358431, -71.059773]);

פרמטרים

שם	סוג	תיאור
points	Number[]	מערך של צמדי קו רוחב/קו אורך שמגדירים את הנתיב.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

addPath(polyline)

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

// Creates a map and adds a path from New York to Boston.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

פרמטרים

שם	סוג	תיאור
polyline	String	קו פוליגוני מקודד.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

addPoint(latitude, longitude)

הוספת נקודה חדשה (קו רוחב/lng) להגדרת הנתיב הנוכחית.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addPoint(40.714353, -74.005973)
    .addPoint(42.358431, -71.059773)
    .endPath();

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הנקודה.
longitude	Number	קו האורך של הנקודה.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

addVisible(latitude, longitude)

מוסיף מיקום של נקודה (קו רוחב/lng) שחייב להיות גלוי במפה.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הנקודה.
longitude	Number	קו האורך של הנקודה.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

addVisible(address)

הוספת מיקום כתובת שחייב להיות גלוי במפה.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

פרמטרים

שם	סוג	תיאור
address	String	כתובת שחייבת להופיע במפה.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

beginPath()

התחלה של הגדרת נתיב חדשה. הקריאות אל addAddress() ואל addPoint() מגדירות כל אחת מהקריאות הקודקוד החדש בנתיב. הנתיב יושלם כשמתבצעת קריאה אל endPath().

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

clearMarkers()

ניקוי קבוצת הסמנים הנוכחית.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

clearPaths()

ניקוי קבוצת הנתיבים הנוכחית.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

clearVisibles()

ניקוי הקבוצה הנוכחית של המיקומים הגלויים.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

endPath()

משלימה הגדרת נתיב שהתחילה ב-startPath().

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

getAs(contentType)

החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "myfile.pdf". עם זאת, מניח שהחלק של שם הקובץ שמופיע אחרי התקופה האחרונה (אם יש) הוא קיים שצריך להחליף. כתוצאה מכך, "ShoppingList.12.25.2014" הופך ל- "ShoppingList.12.25.pdf".

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

פרמטרים

שם	סוג	תיאור
contentType	String	סוג ה-MIME שאליו צריך להמיר. לרוב ה-blobs, 'application/pdf' הוא האפשרות החוקית היחידה. בשביל תמונות בפורמט BMP, GIF, JPEG או PNG, כל אחד מהקריטריונים של 'image/bmp', 'image/gif', 'image/jpeg' או 'image/png' צריך להיות תואם גם תקין. במסמך של Google Docs, גם 'text/markdown' תקף.

חזרה

Blob – הנתונים כ-blob.

---

getBlob()

הפונקציה מקבלת את נתוני התמונה כ-Blob.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(map);  // You can call map.getBlob() explicitly or use it
                           // implicitly by passing the map where a blob is expected.

חזרה

Blob — תמונה של המפה בפורמט התמונה שנבחר.

---

getMapImage()

מקבלת את נתוני התמונה הגולמיים כמערך בייטים.

באופן כללי, עדיף להשתמש ב-getBlob() שמאפשר אינטראקציות פשוטות יותר עם שירותים שונים.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

חזרה

Byte[] — תמונה של המפה בפורמט התמונה שנבחר.

---

getMapUrl()

הפונקציה מקבלת את כתובת ה-URL של תמונת המפה.

// Creates a map centered on Times Square and gets the URL.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
// All static map URLs require an API key.
Logger.log(map.getMapUrl() + "&key=YOUR_API_KEY");

חזרה

String — כתובת URL – כתובת ה-URL של תמונת המפה.

---

setCenter(latitude, longitude)

מגדיר את מרכז המפה באמצעות נקודה (קו רוחב/lng).

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של המרכז.
longitude	Number	קו האורך של המרכז.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setCenter(address)

מגדיר את מרכז המפה באמצעות כתובת.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

פרמטרים

שם	סוג	תיאור
address	String	הכתובת של המרכז.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setCustomMarkerStyle(imageUrl, useShadow)

מגדיר את תמונת הסמן המותאמת אישית לשימוש בעת יצירת סמנים חדשים. סמנים שכבר שנוספו לא יושפעו.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

פרמטרים

שם	סוג	תיאור
imageUrl	String	מציינת כתובת URL שתשמש כסמל המותאם אישית של הסמן. התמונות יכולות להיות בפורמט PNG או JPEG או GIF בפורמט PNG, אם כי מומלץ להשתמש ב-PNG.
useShadow	Boolean	מציין שעל הסמן להיווצר צל, על סמך הערך של התמונה את האזור הגלוי ואת השקיפות/השקיפות שלו.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setFormat(format)

מגדיר את הפורמט של תמונת המפה.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

פרמטרים

שם	סוג	תיאור
format	String	ערך קבוע מ-Format.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setLanguage(language)

הגדרת השפה לשימוש בטקסט במפה (היכן שזמין).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

פרמטרים

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

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• שפות תמיכה בממשקי Google Maps API

---

setMapType(mapType)

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

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

פרמטרים

שם	סוג	תיאור
mapType	String	ערך קבוע מ-Type.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setMarkerStyle(size, color, label)

הגדרת סגנון הסמן לשימוש במהלך יצירת סמנים חדשים. סמנים שכבר נוספו אינן מושפעות.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');

פרמטרים

שם	סוג	תיאור
size	String	ערך קבוע מ-MarkerSize.
color	String	מחרוזת בפורמט "0xrrggbb" או ערך קבוע מ-Color.
label	String	מחרוזת שמכילה את התווים A-Z או 0-9.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setMobile(useMobileTiles)

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

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

פרמטרים

שם	סוג	תיאור
useMobileTiles	Boolean	האם להשתמש במשבצות לנייד או לא.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

---

setPathStyle(weight, color, fillColor)

מגדיר את סגנון הנתיב שישמש ליצירת נתיבים חדשים. נתיבים שכבר נוספו אינם הושפעו.

// Creates a map with paths set to be 1 pixel wide with a black line and a white fill.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

פרמטרים

שם	סוג	תיאור
weight	Integer	רוחב הקווים בפיקסלים.
color	String	צבע הקו, כמחרוזת בפורמט "0xrrggbb" או ערך קבוע מתוך Color
fillColor	String	צבע המילוי, מחרוזת בפורמט "0xrrggbb" או ערך קבוע מתוך Color

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setSize(width, height)

מגדיר את הרוחב והגובה של תמונת המפה בפיקסלים.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

פרמטרים

שם	סוג	תיאור
width	Integer	רוחב התמונה בפיקסלים.
height	Integer	גובה התמונה בפיקסלים.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי

---

setZoom(zoom)

מגדיר את גורם הזום, או רמת ההגדלה, המשמשים במפה.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

פרמטרים

שם	סוג	תיאור
zoom	Integer	ערך בין אפס ל-21, כולל.

חזרה

StaticMap – מופע המפה הזה, ליצירת שרשור.

ראה גם

• API של מפות Google סטטי