Class StaticMap

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	تضيف هذه الطريقة علامة إلى الخريطة باستخدام نقطة (خط العرض/خط الطول).
addMarker(address)	StaticMap	تضيف هذه الطريقة علامة إلى الخريطة باستخدام عنوان.
addPath(points)	StaticMap	تضيف هذه الطريقة مسارًا إلى الخريطة باستخدام مجموعة من النقاط.
addPath(polyline)	StaticMap	تضيف هذه الطريقة مسارًا إلى الخريطة باستخدام خطوط متعدّدة مرمّزة.
addPoint(latitude, longitude)	StaticMap	تضيف هذه السمة نقطة جديدة (خط العرض/خط الطول) إلى تعريف المسار الحالي.
addVisible(latitude, longitude)	StaticMap	تضيف هذه السمة موقعًا جغرافيًا (خط العرض/خط الطول) يجب أن يكون مرئيًا في الخريطة.
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	تضبط هذه السمة مركز الخريطة باستخدام نقطة (خط العرض/خط الطول).
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)

تضيف هذه الطريقة علامة إلى الخريطة باستخدام نقطة (خط العرض/خط الطول).

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

تضيف هذه السمة موقعًا جغرافيًا (خط العرض/خط الطول) يجب أن يكون مرئيًا في الخريطة.

// 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 لصورة الخريطة.

---

setCenter(latitude, longitude)

تضبط هذه السمة مركز الخريطة باستخدام نقطة (خط العرض/خط الطول).

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

---

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