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

انظر أيضًا

• 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	تُضيف نقطة جديدة (خط الطول/خط العرض) إلى تعريف المسار الحالي.
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.
const 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.
const 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.
const 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.
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)

تُضيف نقطة جديدة (خط الطول/خط العرض) إلى تعريف المسار الحالي.

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

تُضيف نقطة موقع جغرافي (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	خط الطول للنقطة

الإرجاع

StaticMap - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

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 - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

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)

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "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"، يكون '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: عنوان 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 - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

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 - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

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,
);

المعلمات

الاسم	النوع	الوصف
imageUrl	String	تُحدِّد عنوان URL لاستخدامه كرمز مخصّص للعلامة. يمكن أن تكون الصور بتنسيق PNG أو JPEG أو GIF، ولكن ننصح باستخدام تنسيق PNG.
useShadow	Boolean	يشير ذلك إلى أنّه يجب إنشاء ظل للعلامة استنادًا إلى المنطقة المرئية من الصورة ومستوى شفافيتها أو عتمتها.

الإرجاع

StaticMap - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

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 - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

setLanguage(language)

لضبط اللغة التي سيتم استخدامها للنص على الخريطة (حيثما كان ذلك متاحًا).

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

المعلمات

الاسم	النوع	الوصف
language	String	معرّف لغة BCP-47

الإرجاع

StaticMap - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• إتاحة اللغات في Google Maps API

---

setMapType(mapType)

لضبط نوع الخريطة التي سيتم عرضها.

// Creates a satellite map.
const 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".
const map = Maps.newStaticMap().setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.BLACK,
    '1',
);

المعلمات

الاسم	النوع	الوصف
size	String	قيمة ثابتة من MarkerSize
color	String	سلسلة بتنسيق ‎0xrrggbb أو قيمة ثابتة من Color
label	String	سلسلة تحتوي على حرف واحد من A إلى Z أو من 0 إلى 9

الإرجاع

StaticMap - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API

---

setMobile(useMobileTiles)

لضبط ما إذا كان سيتم استخدام مجموعات مربّعات مخصّصة للأجهزة الجوّالة أم لا

// Creates a map that uses mobile-friendly tiles.
const 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.
const 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.
const 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.
const map = Maps.newStaticMap().setZoom(10);

المعلمات

الاسم	النوع	الوصف
zoom	Integer	قيمة من صفر إلى 21، شاملة

الإرجاع

StaticMap - مثيل الخريطة هذا، لتسلسل العناصر.

انظر أيضًا

• Google Static Maps API