מאפשר ליצור תמונות סטטיות של מפות ולעצב אותן.
בדוגמה הבאה אפשר לראות איך אפשר להשתמש במחלקה הזו כדי ליצור מפה של אזור התיאטראות בניו יורק, כולל תחנות רכבת סמוכות, ולהציג אותה באפליקציית אינטרנט פשוטה.
// Create a map centered on Times Square. const 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. const 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 (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
ראה גם
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Static | הוספת כתובת חדשה להגדרת הנתיב הנוכחית. |
add | Static | הוספת סמן למפה באמצעות נקודה (קו רוחב/קו אורך). |
add | Static | הוספת סמן למפה באמצעות כתובת. |
add | Static | הוספת נתיב למפה באמצעות מערך של נקודות. |
add | Static | הפונקציה מוסיפה נתיב למפה באמצעות קו פוליגוני מקודד. |
add | Static | הוספת נקודה חדשה (קו רוחב/קו אורך) להגדרת הנתיב הנוכחית. |
add | Static | מוסיף מיקום של נקודה (קו רוחב/קו אורך) שחייב להיות גלוי במפה. |
add | Static | הוספה של מיקום כתובת שחייב להיות גלוי במפה. |
begin | Static | מתחילים הגדרה חדשה של נתיב. |
clear | Static | ניקוי קבוצת הסימנים הנוכחית. |
clear | Static | ניקוי קבוצת הנתיבים הנוכחית. |
clear | Static | מנקה את קבוצת המיקומים הנוכחית שמוצגת. |
end | Static | הפונקציה משלימה הגדרת נתיב שהתחילה בפונקציה beginPath(). |
get | Blob | הפונקציה מחזירה את הנתונים בתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. |
get | Blob | הפונקציה מחזירה את נתוני התמונה כ-Blob. |
get | Byte[] | מחזירה את נתוני התמונה הגולמיים כמערך בייטים. |
get | String | מחזירה את כתובת ה-URL של תמונת המפה. |
set | Static | הגדרת מרכז המפה באמצעות נקודה (קו רוחב/קו אורך). |
set | Static | הגדרת מרכז המפה באמצעות כתובת. |
set | Static | הגדרת תמונה של סמן מותאם אישית לשימוש כשיוצרים סמנים חדשים. |
set | Static | הגדרה של הפורמט של תמונת המפה. |
set | Static | הגדרת השפה שבה יוצג הטקסט במפה (אם יש טקסט). |
set | Static | ההגדרה הזו קובעת את סוג המפה שתוצג. |
set | Static | מגדיר את סגנון הסמן שבו יש להשתמש כשיוצרים סמנים חדשים. |
set | Static | ההגדרה קובעת אם להשתמש במערכות משבצות מיוחדות למכשירים ניידים. |
set | Static | מגדיר את סגנון הנתיב שבו יש להשתמש כשיוצרים נתיבים חדשים. |
set | Static | ההגדרה הזו קובעת את הרוחב והגובה של תמונת המפה בפיקסלים. |
set | Static | הגדרת גורם הזום או רמת ההגדלה שמשמשים במפה. |
תיעוד מפורט
add Address(address)
הוספת כתובת חדשה להגדרת הנתיב הנוכחית.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
address | String | כתובת להוספה. |
חזרה
Static — מופע המפה הזה, לשרשור.
add Marker(latitude, longitude)
הוספת סמן למפה באמצעות נקודה (קו רוחב/קו אורך).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
latitude | Number | קו הרוחב של הסמן החדש. |
longitude | Number | קו האורך של הסמן החדש. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
add Marker(address)
הוספת סמן למפה באמצעות כתובת.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
address | String | הכתובת שבה רוצים למקם את הסמן החדש. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
add Path(points)
הוספת נתיב למפה באמצעות מערך של נקודות.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
points | Number[] | מערך של צמדי קווי אורך ורוחב שמגדירים את הנתיב. |
חזרה
Static — מופע המפה הזה, לשרשור.
add Path(polyline)
הפונקציה מוסיפה נתיב למפה באמצעות קו פוליגוני מקודד.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
polyline | String | קו פוליגוני מקודד. |
חזרה
Static — מופע המפה הזה, לשרשור.
add Point(latitude, longitude)
הוספת נקודה חדשה (קו רוחב/קו אורך) להגדרת הנתיב הנוכחית.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addPoint(40.714353, -74.005973) .addPoint(42.358431, -71.059773) .endPath();
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
latitude | Number | קו הרוחב של הנקודה. |
longitude | Number | קו האורך של הנקודה. |
חזרה
Static — מופע המפה הזה, לשרשור.
add Visible(latitude, longitude)
מוסיף מיקום של נקודה (קו רוחב/קו אורך) שחייב להיות גלוי במפה.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
latitude | Number | קו הרוחב של הנקודה. |
longitude | Number | קו האורך של הנקודה. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
add Visible(address)
הוספה של מיקום כתובת שחייב להיות גלוי במפה.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
address | String | כתובת שחייבת להיות גלויה במפה. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
begin Path()
מתחילים הגדרה חדשה של נתיב. קריאות ל-add ול-add מגדירות כל קודקוד חדש בנתיב. הנתיב מסתיים כשמתבצעת קריאה ל-end.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
חזרה
Static — מופע המפה הזה, לשרשור.
clear Markers()
ניקוי קבוצת הסימנים הנוכחית.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
חזרה
Static — מופע המפה הזה, לשרשור.
clear Paths()
ניקוי קבוצת הנתיבים הנוכחית.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
חזרה
Static — מופע המפה הזה, לשרשור.
clear Visibles()
מנקה את קבוצת המיקומים הנוכחית שמוצגת.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
חזרה
Static — מופע המפה הזה, לשרשור.
end Path()
הפונקציה משלימה הגדרת נתיב שהתחילה בפונקציה beginPath().
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
חזרה
Static — מופע המפה הזה, לשרשור.
get As(contentType)
הפונקציה מחזירה את הנתונים בתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. בשיטה הזו, הסיומת המתאימה מתווספת לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, המערכת מניחה שחלק משם הקובץ שאחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. לכן, 'ShoppingList.12.25.2014' הופך ל-'ShoppingList.12.25.pdf'.
כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר בנושא מכסות לשירותי Google. יכול להיות שדומיינים חדשים ב-Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
content | String | סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blob, 'application/pdf' היא האפשרות התקפה היחידה. אם התמונות בפורמט BMP, GIF, JPEG או PNG, אפשר להשתמש גם באחד מהערכים 'image/bmp', 'image/gif', 'image/jpeg' או 'image/png'. במסמך Google Docs, הערך 'text/markdown' תקף גם כן. |
חזרה
Blob — הנתונים כ-blob.
get Blob()
הפונקציה מחזירה את נתוני התמונה כ-Blob.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
חזרה
Blob – תמונה של המפה בפורמט התמונה שנבחר.
get Map Image()
מחזירה את נתוני התמונה הגולמיים כמערך בייטים.
באופן כללי, עדיף להשתמש ב-get שמאפשר אינטראקציות פשוטות יותר עם שירותים אחרים.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
חזרה
Byte[] – תמונה של המפה בפורמט התמונה שנבחר.
get Map Url()
מחזירה את כתובת ה-URL של תמונת המפה.
// Creates a map centered on Times Square and gets the URL. const 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 של תמונת המפה.
set Center(latitude, longitude)
הגדרת מרכז המפה באמצעות נקודה (קו רוחב/קו אורך).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
latitude | Number | קו הרוחב של המרכז. |
longitude | Number | קו האורך של המרכז. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Center(address)
הגדרת מרכז המפה באמצעות כתובת.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
address | String | הכתובת של המרכז. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Custom Marker Style(imageUrl, useShadow)
הגדרת תמונה של סמן מותאם אישית לשימוש כשיוצרים סמנים חדשים. הסמנים שכבר נוספו לא יושפעו.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
image | String | מציינת כתובת URL לשימוש כסמל מותאם אישית של הסמן. התמונות יכולות להיות בפורמטים PNG, JPEG או GIF, אבל מומלץ להשתמש בפורמט PNG. |
use | Boolean | מציין שהסמן צריך לכלול צל שנוצר על סמך האזור הגלוי של התמונה והאטימות או השקיפות שלה. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Format(format)
set Language(language)
הגדרת השפה שבה יוצג הטקסט במפה (אם יש טקסט).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
language | String | מזהה שפה בפורמט BCP-47. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Map Type(mapType)
set Marker Style(size, color, label)
מגדיר את סגנון הסמן שבו יש להשתמש כשיוצרים סמנים חדשים. השינוי לא ישפיע על סמנים שכבר נוספו.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
size | String | ערך קבוע מ-Marker. |
color | String | מחרוזת בפורמט '0xrrggbb' או ערך קבוע מ-Color. |
label | String | מחרוזת שמכילה תו יחיד A-Z או 0-9. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Mobile(useMobileTiles)
ההגדרה קובעת אם להשתמש במערכות משבצות מיוחדות למכשירים ניידים.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
use | Boolean | האם להשתמש במשבצות בנייד. |
חזרה
Static — מופע המפה הזה, לשרשור.
set Path Style(weight, color, fillColor)
מגדיר את סגנון הנתיב שבו יש להשתמש כשיוצרים נתיבים חדשים. הנתיבים שכבר נוספו לא מושפעים.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
weight | Integer | רוחב הקווים בפיקסלים. |
color | String | צבע הקו, כמחרוזת בפורמט '0xrrggbb' או כערך קבוע מתוך
Color. |
fill | String | צבע המילוי, מחרוזת בפורמט '0xrrggbb' או ערך קבוע מתוך
Color. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Size(width, height)
ההגדרה הזו קובעת את הרוחב והגובה של תמונת המפה בפיקסלים.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
width | Integer | רוחב התמונה בפיקסלים. |
height | Integer | גובה התמונה בפיקסלים. |
חזרה
Static — מופע המפה הזה, לשרשור.
ראה גם
set Zoom(zoom)
הגדרת גורם הזום או רמת ההגדלה שמשמשים במפה.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
zoom | Integer | ערך בין אפס ל-21, כולל. |
חזרה
Static — מופע המפה הזה, לשרשור.