Class StaticMap

تُضيف عنوانًا جديدًا إلى تعريف المسار الحالي.

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

تُضيف علامة إلى الخريطة باستخدام نقطة (lat/lng).

// Creates a map and adds a marker at the specified coordinates.
const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

تُضيف علامة إلى الخريطة باستخدام عنوان.

// Creates a map and adds a marker at the specified address.
const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

تُضيف مسارًا إلى الخريطة باستخدام صفيف من النقاط.

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

المعلمات

الإرجاع

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

تُضيف مسارًا إلى الخريطة باستخدام خط متعدد الأضلاع مشفَّر.

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

المعلمات

الإرجاع

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

تُضيف نقطة جديدة (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();

المعلمات

الإرجاع

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

تُضيف نقطة موقع (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);

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

يبدأ تعريف مسار جديد. تحدّد طلبات 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 - مثيل الخريطة هذا، لتسلسل العناصر.

يؤدي إلى محو المجموعة الحالية من العلامات.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

الإرجاع

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

محو المجموعة الحالية من المسارات

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

الإرجاع

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

يؤدي إلى محو المجموعة الحالية من المواقع الجغرافية المرئية.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

الإرجاع

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

تُكمِل تعريف مسار بدأ بالاستدعاء 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 - مثيل الخريطة هذا، لتسلسل العناصر.

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

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

المعلمات

الإرجاع

‫Blob: البيانات بتنسيق ملف نصي

تحصل على بيانات الصورة بتنسيق 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 - صورة للخريطة بتنسيق الصورة المحدّد

تحصل على بيانات الصورة الأولية كمصفوفة بايت.

بشكل عام، ننصحك باستخدام 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[] - صورة للخريطة بتنسيق الصورة المحدّد

تحصل على عنوان 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 لصورة الخريطة.

تُستخدَم لضبط مركز الخريطة باستخدام نقطة (lat/lng).

// Creates a map centered on Times Square, using its coordinates.
const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

لضبط صورة العلامة المخصّصة لاستخدامها عند إنشاء علامات جديدة. ولن تتأثر العلامات التي سبق أن تمّت إضافتها.

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

انظر أيضًا

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

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

لضبط نمط العلامة المميّزة لاستخدامه عند إنشاء علامات جديدة. ولن تتأثر العلامات التي سبق إضافتها.

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

لضبط نمط المسار لاستخدامه عند إنشاء مسارات جديدة. ولن تتأثّر المسارات التي سبق أن تمت إضافتها.

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

لضبط عرض صورة الخريطة وارتفاعها بالبكسل

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API

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

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

المعلمات

الإرجاع

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

انظر أيضًا

• Google Static Maps API