Class StaticMap

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

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

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

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

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API

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

// Creates a map and adds a marker at the specified address.
var 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.
var 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.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

المَعلمات

استرجاع الكرة

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

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

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

المَعلمات

استرجاع الكرة

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

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

// Creates a map where New York and Boston are visible.
var 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.
var 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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

استرجاع الكرة

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

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

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

استرجاع الكرة

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

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

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

استرجاع الكرة

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

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

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

استرجاع الكرة

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

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

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

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

المَعلمات

استرجاع الكرة

Blob — البيانات في صورة كائن ثنائي كبير (blob).

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

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

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

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

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

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

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API

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

// Creates a map centered on Times Square, using its address.
var 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".
var 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.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API

لتعيين اللغة التي سيتم استخدامها للنص على الخريطة (حيث تتوفر).

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

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• دعم اللغة في واجهات برمجة التطبيقات لخرائط Google

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

// Creates a satellite map.
var 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".
var 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.
var 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.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API

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

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

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API

تعيين عامل التكبير/التصغير، أو مستوى التكبير المستخدم للخريطة.

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

المَعلمات

استرجاع الكرة

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

يمكن أيضًا مراجعة

• Google Static Maps API