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

انظر أيضًا

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

المعلمات

الاسمالنوعالوصف
addressStringعنوان تريد إضافته

الإرجاع

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

المعلمات

الاسمالنوعالوصف
latitudeNumberخط العرض للعلامة الجديدة.
longitudeNumberخط الطول للعلامة الجديدة.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
addressStringالعنوان الذي سيتم وضع العلامة الجديدة عليه

الإرجاع

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

المعلمات

الاسمالنوعالوصف
pointsNumber[]مصفوفة من أزواج خطوط العرض/خطوط الطول التي تحدّد المسار

الإرجاع

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

المعلمات

الاسمالنوعالوصف
polylineStringخط متعدد مُشفَّر

الإرجاع

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

المعلمات

الاسمالنوعالوصف
latitudeNumberخط العرض للنقطة
longitudeNumberخط الطول للنقطة

الإرجاع

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

المعلمات

الاسمالنوعالوصف
latitudeNumberخط العرض للنقطة
longitudeNumberخط الطول للنقطة

الإرجاع

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

انظر أيضًا


addVisible(address)

تُضيف موقعًا جغرافيًا لعنوان يجب أن يكون مرئيًا في الخريطة.

// Creates a map where New York and Boston are visible.
const map =
    Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');

المعلمات

الاسمالنوعالوصف
addressStringعنوان يجب أن يكون مرئيًا في الخريطة

الإرجاع

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)

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه يفترض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد حالي يجب استبداله. ونتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو ShoppingList.12.25.pdf.

للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.

المعلمات

الاسمالنوعالوصف
contentTypeStringنوع 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);

المعلمات

الاسمالنوعالوصف
latitudeNumberخط العرض للمركز
longitudeNumberخط الطول للمركز

الإرجاع

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

انظر أيضًا


setCenter(address)

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

// Creates a map centered on Times Square, using its address.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

المعلمات

الاسمالنوعالوصف
addressStringعنوان المركز

الإرجاع

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

المعلمات

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

الإرجاع

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

انظر أيضًا


setFormat(format)

لضبط تنسيق صورة الخريطة

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

المعلمات

الاسمالنوعالوصف
formatStringقيمة ثابتة من Format

الإرجاع

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

انظر أيضًا


setLanguage(language)

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

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

المعلمات

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

الإرجاع

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

انظر أيضًا


setMapType(mapType)

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

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

المعلمات

الاسمالنوعالوصف
mapTypeStringقيمة ثابتة من 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',
);

المعلمات

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

الإرجاع

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

انظر أيضًا


setMobile(useMobileTiles)

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

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

المعلمات

الاسمالنوعالوصف
useMobileTilesBooleanما إذا كان سيتم استخدام شاشات المعلومات المخصّصة للأجهزة الجوّالة أم لا

الإرجاع

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

المعلمات

الاسمالنوعالوصف
weightIntegerعرض الخطوط بالبكسل
colorStringلون الخط، كسلسلة بتنسيق ‎0xrrggbb أو قيمة ثابتة من Color.
fillColorStringلون التعبئة، أو سلسلة بتنسيق ‎0xrrggbb أو قيمة ثابتة من Color.

الإرجاع

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

انظر أيضًا


setSize(width, height)

تُستخدَم لضبط عرض صورة الخريطة وارتفاعها بالبكسل.

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

المعلمات

الاسمالنوعالوصف
widthIntegerعرض الصورة بالبكسل
heightIntegerارتفاع الصورة بالبكسل

الإرجاع

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

انظر أيضًا


setZoom(zoom)

لضبط عامل التكبير أو مستوى التكبير المستخدَم للخريطة

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

المعلمات

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

الإرجاع

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

انظر أيضًا