Class StaticMap

نقشه استاتیک

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

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

// 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 ضریب بزرگنمایی یا سطح بزرگنمایی مورد استفاده برای نقشه را تنظیم می‌کند.

مستندات دقیق

addAddress(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 آدرسی برای اضافه کردن.

بازگشت

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

addMarker(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 طول جغرافیایی نشانگر جدید.

بازگشت

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

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

addMarker(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 آدرسی که نشانگر جدید در آن قرار می‌گیرد.

بازگشت

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

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

addPath(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[] آرایه‌ای از جفت‌های طول و عرض جغرافیایی که مسیر را تعریف می‌کنند.

بازگشت

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

addPath(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 یک چندخطی کدگذاری شده.

بازگشت

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

addPoint(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 طول جغرافیایی نقطه.

بازگشت

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

addVisible(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 طول جغرافیایی نقطه.

بازگشت

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

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

addVisible(address)

یک مکان آدرس اضافه می‌کند که باید در نقشه قابل مشاهده باشد.

// Creates a map where New York and Boston are visible.
const 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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

بازگشت

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

clearMarkers()

مجموعه نشانگرهای فعلی را پاک می‌کند. 

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

بازگشت

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

clearPaths()

مجموعه مسیرهای فعلی را پاک کنید. 

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

بازگشت

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

clearVisibles()

مجموعه فعلی مکان‌های قابل مشاهده را پاک می‌کند. 

const 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.
const 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 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 - داده‌ها به عنوان یک حباب.

getBlob()

داده‌های تصویر را به صورت یک 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 — تصویری از نقشه در قالب تصویر انتخاب شده.

getMapImage()

داده‌های خام تصویر را به صورت آرایه‌ای از بایت‌ها دریافت می‌کند.

به طور کلی، استفاده از getBlob() را ترجیح دهید که امکان تعامل ساده‌تر با سایر سرویس‌ها را فراهم می‌کند. 

// 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[] — تصویری از نقشه در قالب تصویر انتخاب شده.

getMapUrl()

آدرس اینترنتی (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) آدرس اینترنتی تصویر نقشه.

setCenter(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 طول جغرافیایی مرکز.

بازگشت

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

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

setCenter(address)

مرکز نقشه را با استفاده از یک آدرس تنظیم می‌کند. 

// Creates a map centered on Times Square, using its address.
const 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".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

پارامترها

نام نوع توضیحات
image Url String یک URL برای استفاده به عنوان آیکون سفارشی نشانگر مشخص می‌کند. تصاویر می‌توانند در قالب‌های PNG، JPEG یا GIF باشند، اگرچه PNG توصیه می‌شود.
use Shadow Boolean نشان می‌دهد که نشانگر باید بر اساس ناحیه قابل مشاهده تصویر و میزان کدری/شفافیت آن، سایه‌ای ایجاد کند.

بازگشت

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

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

setFormat(format)

قالب تصویر نقشه را تنظیم می‌کند. 

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

پارامترها

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

بازگشت

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

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

setLanguage(language)

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

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

پارامترها

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

بازگشت

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

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

setMapType(mapType)

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

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

پارامترها

نام نوع توضیحات
map Type String یک مقدار ثابت از Type .

بازگشت

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

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

setMarkerStyle(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 یا اعداد ۰ تا ۹ است.

بازگشت

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

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

setMobile(useMobileTiles)

تنظیم می‌کند که آیا از مجموعه‌های کاشی تخصصی برای دستگاه‌های تلفن همراه استفاده شود یا خیر. 

// Creates a map that uses mobile-friendly tiles.
const map = Maps.newStaticMap().setMobile(true);

پارامترها

نام نوع توضیحات
use Mobile Tiles 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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

پارامترها

نام نوع توضیحات
weight Integer عرض خطوط بر حسب پیکسل.
color String رنگ خط، به صورت یک رشته با فرمت "0xrrggbb" یا یک مقدار ثابت از Color .
fill Color String رنگ پرکننده، یک رشته با فرمت "0xrrggbb" یا یک مقدار ثابت از Color .

بازگشت

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

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

setSize(width, height)

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

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

پارامترها

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

بازگشت

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

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

setZoom(zoom)

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

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

پارامترها

نام نوع توضیحات
zoom Integer مقداری از صفر تا ۲۱، شامل همه.

بازگشت

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

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