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

انظر أيضًا

• 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	يكمل تعريف مسار يبدأ بـ startPath().
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.
var 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.
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)

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

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

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

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

يكمل تعريف مسار يبدأ بـ startPath().

// 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"، يُعدّ 'text/markdown' أيضًا صالحًا.

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (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)

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

// 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	تحدد عنوان URL لاستخدامه كرمز مخصص للعلامة. يمكن أن تكون الصور بتنسيق 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

---

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	سلسلة تحتوي على حرف واحد A-Z أو 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