امکان ایجاد و تزئین تصاویر نقشه ایستا را فراهم می کند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس برای ایجاد نقشهای از منطقه تئاتر شهر نیویورک، از جمله ایستگاههای قطار مجاور، و نمایش آن در یک برنامه وب ساده استفاده کنید.
// 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`;
همچنین ببینید
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
add Address(address) | Static Map | یک آدرس جدید به تعریف مسیر فعلی اضافه می کند. |
add Marker(latitude, longitude) | Static Map | با استفاده از یک نقطه (lat/lng) یک نشانگر به نقشه اضافه می کند. |
add Marker(address) | Static Map | با استفاده از آدرس، نشانگر را به نقشه اضافه می کند. |
add Path(points) | Static Map | با استفاده از آرایه ای از نقاط، مسیری را به نقشه اضافه می کند. |
add Path(polyline) | Static Map | با استفاده از چند خط کدگذاری شده، مسیری را به نقشه اضافه می کند. |
add Point(latitude, longitude) | Static Map | یک نقطه جدید (lat/lng) به تعریف مسیر فعلی اضافه می کند. |
add Visible(latitude, longitude) | Static Map | مکان نقطه ای (lat/lng) را اضافه می کند که باید در نقشه قابل مشاهده باشد. |
add Visible(address) | Static Map | یک مکان آدرس را اضافه می کند که باید در نقشه قابل مشاهده باشد. |
begin Path() | Static Map | تعریف مسیر جدیدی را شروع می کند. |
clear Markers() | Static Map | مجموعه فعلی نشانگرها را پاک می کند. |
clear Paths() | Static Map | مجموعه مسیرهای فعلی را پاک کنید. |
clear Visibles() | Static Map | مجموعه فعلی مکانهای قابل مشاهده را پاک میکند. |
end Path() | Static Map | تعریف مسیری را که با () beginPath شروع شده است را تکمیل می کند. |
get As(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
get Blob() | Blob | داده های تصویر را به صورت Blob دریافت می کند. |
get Map Image() | Byte[] | داده های تصویر خام را به عنوان یک آرایه بایت دریافت می کند. |
get Map Url() | String | URL تصویر نقشه را دریافت می کند. |
set Center(latitude, longitude) | Static Map | مرکز نقشه را با استفاده از یک نقطه (lat/lng) تنظیم می کند. |
set Center(address) | Static Map | مرکز نقشه را با استفاده از یک آدرس تنظیم می کند. |
set Custom Marker Style(imageUrl, useShadow) | Static Map | تصویر نشانگر سفارشی را برای استفاده هنگام ایجاد نشانگرهای جدید تنظیم می کند. |
set Format(format) | Static Map | فرمت تصویر نقشه را تنظیم می کند. |
set Language(language) | Static Map | زبان مورد استفاده برای متن روی نقشه (در صورت وجود) را تنظیم می کند. |
set Map Type(mapType) | Static Map | نوع نقشه نمایش داده شده را تنظیم می کند. |
set Marker Style(size, color, label) | Static Map | سبک نشانگر را برای استفاده هنگام ایجاد نشانگرهای جدید تنظیم می کند. |
set Mobile(useMobileTiles) | Static Map | تعیین می کند که آیا از مجموعه کاشی های تخصصی برای دستگاه های تلفن همراه استفاده شود یا خیر. |
set Path Style(weight, color, fillColor) | Static Map | سبک مسیر را برای استفاده هنگام ایجاد مسیرهای جدید تنظیم می کند. |
set Size(width, height) | Static Map | عرض و ارتفاع تصویر نقشه را بر حسب پیکسل تنظیم می کند. |
set Zoom(zoom) | Static Map | ضریب بزرگنمایی یا سطح بزرگنمایی مورد استفاده برای نقشه را تنظیم می کند. |
مستندات دقیق
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 Map
- این نمونه نقشه، برای زنجیر کردن.
add Marker(latitude, longitude)
با استفاده از یک نقطه (lat/lng) یک نشانگر به نقشه اضافه می کند.
// 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 Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Map
- این نمونه نقشه، برای زنجیر کردن.
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 Map
- این نمونه نقشه، برای زنجیر کردن.
add Point(latitude, longitude)
یک نقطه جدید (lat/lng) به تعریف مسیر فعلی اضافه می کند.
// 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 Map
- این نمونه نقشه، برای زنجیر کردن.
add Visible(latitude, longitude)
مکان نقطه ای (lat/lng) را اضافه می کند که باید در نقشه قابل مشاهده باشد.
// 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 Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
begin Path()
تعریف مسیر جدیدی را شروع می کند. فراخوانی برای add Address()
و add Point()
هر راس جدید را در مسیر تعریف می کند. مسیر با فراخوانی end Path()
تکمیل می شود.
// 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 Map
- این نمونه نقشه، برای زنجیر کردن.
clear Markers()
مجموعه فعلی نشانگرها را پاک می کند.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
clear Paths()
مجموعه مسیرهای فعلی را پاک کنید.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
clear Visibles()
مجموعه فعلی مکانهای قابل مشاهده را پاک میکند.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
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 Map
- این نمونه نقشه، برای زنجیر کردن.
get As(contentType)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین دوره (در صورت وجود) میآید، یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" تبدیل به "ShoppingList.12.25.pdf" می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنههای جدید Google Workspace ممکن است به طور موقت مشمول سهمیههای سختگیرانهتر شوند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
content Type | String | نوع MIME برای تبدیل. برای اکثر حبابها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است. |
بازگشت
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 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( 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)
مرکز نقشه را با استفاده از یک نقطه (lat/lng) تنظیم می کند.
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
latitude | Number | عرض جغرافیایی مرکز. |
longitude | Number | طول جغرافیایی مرکز. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Url | String | نشانی اینترنتی را برای استفاده به عنوان نماد سفارشی نشانگر مشخص می کند. تصاویر ممکن است در فرمتهای PNG، JPEG یا GIF باشند، اگرچه PNG توصیه میشود. |
use Shadow | Boolean | نشان میدهد که نشانگر باید سایهای بر اساس ناحیه قابل مشاهده تصویر و کدورت/شفافیت آن ایجاد شود. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Format(format)
فرمت تصویر نقشه را تنظیم می کند.
// Creates a map with the image format set to PNG. const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
format | String | یک مقدار ثابت از Format . |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Language(language)
زبان مورد استفاده برای متن روی نقشه (در صورت وجود) را تنظیم می کند.
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
language | String | شناسه زبان BCP-47. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Map Type(mapType)
نوع نقشه نمایش داده شده را تنظیم می کند.
// Creates a satellite map. const map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
map Type | String | یک مقدار ثابت از Type . |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
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 Size . |
color | String | یک رشته با فرمت "0xrrggbb" یا یک مقدار ثابت از Color . |
label | String | رشته ای حاوی یک کاراکتر AZ یا 0-9. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Mobile(useMobileTiles)
تعیین می کند که آیا از مجموعه کاشی های تخصصی برای دستگاه های تلفن همراه استفاده شود یا خیر.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
use Mobile Tiles | Boolean | اینکه آیا از کاشی های متحرک استفاده کنیم یا نه. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
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 Color | String | رنگ پر، یک رشته با فرمت "0xrrggbb" یا یک مقدار ثابت از Color . |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Size(width, height)
عرض و ارتفاع تصویر نقشه را بر حسب پیکسل تنظیم می کند.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
width | Integer | عرض تصویر بر حسب پیکسل |
height | Integer | ارتفاع تصویر بر حسب پیکسل |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.
همچنین ببینید
set Zoom(zoom)
ضریب بزرگنمایی یا سطح بزرگنمایی مورد استفاده برای نقشه را تنظیم می کند.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
zoom | Integer | یک مقدار از صفر تا 21، شامل. |
بازگشت
Static Map
- این نمونه نقشه، برای زنجیر کردن.