Class StaticMap

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

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

مواد و روش ها

روش نوع برگشت توضیح مختصر
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 - این نمونه نقشه، برای زنجیر کردن.

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

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)

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

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

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

تعریف مسیری را که با () 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' نیز معتبر هستند.

برگشت

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

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

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

برگشت

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

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

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

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

setLanguage(language)

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

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

مولفه های

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

برگشت

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

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

setMapType(mapType)

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

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

مولفه های

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

برگشت

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

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

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

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

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

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