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