این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class StaticMap

امکان ایجاد و تزئین تصاویر نقشه ایستا را فراهم می کند.

مثال زیر نشان می‌دهد که چگونه می‌توانید از این کلاس برای ایجاد نقشه‌ای از منطقه تئاتر شهر نیویورک، از جمله ایستگاه‌های قطار مجاور، و نمایش آن در یک برنامه وب ساده استفاده کنید.

// 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";

همچنین ببینید

Google Static Maps API

روش ها

روش	نوع برگشت	شرح مختصر
`addAddress(address)`	`StaticMap`	یک آدرس جدید به تعریف مسیر فعلی اضافه می کند.
`addMarker(latitude, longitude)`	`StaticMap`	با استفاده از یک نقطه (lat/lng) یک نشانگر به نقشه اضافه می کند.
`addMarker(address)`	`StaticMap`	با استفاده از آدرس، نشانگر را به نقشه اضافه می کند.
`addPath(points)`	`StaticMap`	با استفاده از آرایه ای از نقاط، مسیری را به نقشه اضافه می کند.
`addPath(polyline)`	`StaticMap`	با استفاده از چند خط کدگذاری شده، مسیری را به نقشه اضافه می کند.
`addPoint(latitude, longitude)`	`StaticMap`	یک نقطه جدید (lat/lng) به تعریف مسیر فعلی اضافه می کند.
`addVisible(latitude, longitude)`	`StaticMap`	مکان نقطه ای (lat/lng) را اضافه می کند که باید در نقشه قابل مشاهده باشد.
`addVisible(address)`	`StaticMap`	یک مکان آدرس را اضافه می کند که باید در نقشه قابل مشاهده باشد.
`beginPath()`	`StaticMap`	تعریف مسیر جدیدی را شروع می کند.
`clearMarkers()`	`StaticMap`	مجموعه فعلی نشانگرها را پاک می کند.
`clearPaths()`	`StaticMap`	مجموعه مسیرهای فعلی را پاک کنید.
`clearVisibles()`	`StaticMap`	مجموعه فعلی مکان‌های قابل مشاهده را پاک می‌کند.
`endPath()`	`StaticMap`	تعریف مسیری را که با () beginPath شروع شده است را تکمیل می کند.
`getAs(contentType)`	`Blob`	داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
`getBlob()`	`Blob`	داده های تصویر را به صورت `Blob` دریافت می کند.
`getMapImage()`	`Byte[]`	داده های تصویر خام را به عنوان یک آرایه بایت دریافت می کند.
`getMapUrl()`	`String`	URL تصویر نقشه را دریافت می کند.
`setCenter(latitude, longitude)`	`StaticMap`	مرکز نقشه را با استفاده از یک نقطه (lat/lng) تنظیم می کند.
`setCenter(address)`	`StaticMap`	مرکز نقشه را با استفاده از یک آدرس تنظیم می کند.
`setCustomMarkerStyle(imageUrl, useShadow)`	`StaticMap`	تصویر نشانگر سفارشی را برای استفاده هنگام ایجاد نشانگرهای جدید تنظیم می کند.
`setFormat(format)`	`StaticMap`	فرمت تصویر نقشه را تنظیم می کند.
`setLanguage(language)`	`StaticMap`	زبان مورد استفاده برای متن روی نقشه (جایی که در دسترس است) را تنظیم می کند.
`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)`

با استفاده از یک نقطه (lat/lng) یک نشانگر به نقشه اضافه می کند.

// 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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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)`

یک نقطه جدید (lat/lng) به تعریف مسیر فعلی اضافه می کند.

// 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)`

مکان نقطه ای (lat/lng) را اضافه می کند که باید در نقشه قابل مشاهده باشد.

// 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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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()`

تعریف مسیری را که با () beginPath شروع شده است را تکمیل می کند.

// 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)`

داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.

برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است به طور موقت مشمول سهمیه‌های سخت‌گیرانه‌تر شوند.

پارامترها

نام	تایپ کنید	توضیحات
`contentType`	`String`	نوع MIME برای تبدیل. برای اکثر حباب‌ها، `'application/pdf'` تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از `'image/bmp'` ، `'image/gif'` ، `'image/jpeg'` یا `'image/png'` نیز معتبر هستند. برای سند Google Docs، `'text/markdown'` نیز معتبر است.

بازگشت

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)`

مرکز نقشه را با استفاده از یک نقطه (lat/lng) تنظیم می کند.

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

پارامترها

نام	تایپ کنید	توضیحات
`latitude`	`Number`	عرض جغرافیایی مرکز.
`longitude`	`Number`	طول جغرافیایی مرکز.

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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`	نشانی اینترنتی را برای استفاده به عنوان نماد سفارشی نشانگر مشخص می کند. تصاویر ممکن است در فرمت‌های PNG، JPEG یا GIF باشند، اگرچه PNG توصیه می‌شود.
`useShadow`	`Boolean`	نشان می‌دهد که نشانگر باید سایه‌ای بر اساس ناحیه قابل مشاهده تصویر و کدورت/شفافیت آن ایجاد شود.

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`setFormat(format)`

فرمت تصویر نقشه را تنظیم می کند.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

پارامترها

نام	تایپ کنید	توضیحات
`format`	`String`	یک مقدار ثابت از `Format` .

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`setLanguage(language)`

زبان مورد استفاده برای متن روی نقشه (جایی که در دسترس است) را تنظیم می کند.

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

پارامترها

نام	تایپ کنید	توضیحات
`language`	`String`	شناسه زبان BCP-47.

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

پشتیبانی زبان در Google Maps API

`setMapType(mapType)`

نوع نقشه نمایش داده شده را تنظیم می کند.

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

پارامترها

نام	تایپ کنید	توضیحات
`mapType`	`String`	یک مقدار ثابت از `Type` .

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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`	رشته ای حاوی یک کاراکتر AZ یا 0-9.

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`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 - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`setSize(width, height)`

عرض و ارتفاع تصویر نقشه را بر حسب پیکسل تنظیم می کند.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

پارامترها

نام	تایپ کنید	توضیحات
`width`	`Integer`	عرض تصویر بر حسب پیکسل
`height`	`Integer`	ارتفاع تصویر بر حسب پیکسل

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API

`setZoom(zoom)`

ضریب بزرگنمایی یا سطح بزرگنمایی مورد استفاده برای نقشه را تنظیم می کند.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

پارامترها

نام	تایپ کنید	توضیحات
`zoom`	`Integer`	یک مقدار از صفر تا 21، شامل.

بازگشت

StaticMap - این نمونه نقشه، برای زنجیر کردن.

همچنین ببینید

Google Static Maps API