מאפשר יצירה וקישוט של תמונות מפה סטטיות.
הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו כדי ליצור מפה של מחוז התיאטרון של ניו יורק, כולל תחנות רכבת קרובות, ולהציג אותה באפליקציית אינטרנט פשוטה.
// 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";
כדאי לעיין גם בפרטים הבאים
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
addAddress(address) | StaticMap | הוספת כתובת חדשה להגדרת הנתיב הנוכחית. |
addMarker(latitude, longitude) | StaticMap | הוספת סמן למפה באמצעות נקודה (קו רוחב/אורך). |
addMarker(address) | StaticMap | הוספת סמן למפה באמצעות כתובת. |
addPath(points) | StaticMap | הוספה של נתיב למפה באמצעות מערך של נקודות. |
addPath(polyline) | StaticMap | מוסיף נתיב למפה באמצעות קו פוליגוני מקודד. |
addPoint(latitude, longitude) | StaticMap | מוסיף נקודה חדשה (קו רוחב/אורך) להגדרת הנתיב הנוכחית. |
addVisible(latitude, longitude) | StaticMap | מוסיף מיקום נקודה (קו רוחב/אורך) שחייב להיות גלוי במפה. |
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 | מגדיר את מרכז המפה באמצעות נקודה (קו רוחב/אורך). |
setCenter(address) | StaticMap | הגדרת מרכז המפה באמצעות כתובת. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | מגדיר את תמונת הסמן המותאמת אישית לשימוש בעת יצירת סמנים חדשים. |
setFormat(format) | StaticMap | מגדיר את הפורמט של תמונת המפה. |
setLanguage(language) | StaticMap | מגדיר את השפה לשימוש בטקסט במפה (כאשר avaialbe). |
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)
הוספת סמן למפה באמצעות נקודה (קו רוחב/אורך).
// 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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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)
מוסיף נקודה חדשה (קו רוחב/אורך) להגדרת הנתיב הנוכחית.
// 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)
מוסיף מיקום נקודה (קו רוחב/אורך) שחייב להיות גלוי במפה.
// 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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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 שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, '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' . |
החזרות
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)
מגדיר את מרכז המפה באמצעות נקודה (קו רוחב/אורך).
// Creates a map centered on Times Square, using its coordinates. var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
latitude | Number | קו הרוחב של המרכז. |
longitude | Number | קו האורך של המרכז. |
החזרות
StaticMap
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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. |
useShadow | Boolean | מציינת שעל הסמן ליצור צל על סמך האזור הגלוי של התמונה והשקיפות/השקיפות שלה. |
החזרות
StaticMap
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
setFormat(format)
setLanguage(language)
מגדיר את השפה לשימוש בטקסט במפה (כאשר avaialbe).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
language | String | מזהה שפה מסוג BCP-47. |
החזרות
StaticMap
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
setMapType(mapType)
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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
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
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
setSize(width, height)
מגדיר את הרוחב והגובה של תמונת המפה בפיקסלים.
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
width | Integer | רוחב התמונה בפיקסלים. |
height | Integer | גובה התמונה בפיקסלים. |
החזרות
StaticMap
– מופע המפה הזה, לשרשרת.
כדאי לעיין גם בפרטים הבאים
setZoom(zoom)
מגדיר את גורם המרחק מהתצוגה, או את רמת ההגדלה, שישמשו עבור המפה.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
zoom | Integer | ערך בין אפס ל-21, כולל. |
החזרות
StaticMap
– מופע המפה הזה, לשרשרת.