امکان ایجاد و تزئین تصاویر نقشه ثابت را فراهم میکند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس برای ایجاد نقشهای از منطقه تئاتر شهر نیویورک، شامل ایستگاههای قطار نزدیک، و نمایش آن در یک برنامه وب ساده استفاده کنید.
// 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 | با استفاده از یک نقطه (عرض/طول) یک نشانگر به نقشه اضافه میکند. |
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 | یک موقعیت نقطهای (عرض/طول) اضافه میکند که باید در نقشه قابل مشاهده باشد. |
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 | دادههای درون این شیء را به صورت یک 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)
با استفاده از یک نقطه (عرض/طول) یک نشانگر به نقشه اضافه میکند.
// 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)
یک موقعیت نقطهای (عرض/طول) اضافه میکند که باید در نقشه قابل مشاهده باشد.
// 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)
دادههای درون این شیء را به صورت یک blob تبدیلشده به نوع محتوای مشخصشده برمیگرداند. این متد پسوند مناسب را به نام فایل اضافه میکند - برای مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) میآید، یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل میشود.
برای مشاهده سهمیههای روزانه برای تبدیلها، به سهمیههای سرویسهای گوگل مراجعه کنید. دامنههای جدید Google Workspace ممکن است موقتاً مشمول سهمیههای سختگیرانهتری باشند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
content Type | String | نوع MIME برای تبدیل. برای اکثر blobها، '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) آدرس اینترنتی تصویر نقشه.
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 | یک URL برای استفاده به عنوان آیکون سفارشی نشانگر مشخص میکند. تصاویر میتوانند در قالبهای 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 یا اعداد ۰ تا ۹ است. |
بازگشت
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 | مقداری از صفر تا ۲۱، شامل همه. |
بازگشت
Static Map - این نمونه نقشه، برای زنجیرهسازی.