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

انظر أيضًا

الطُرق

الطريقةنوع الإرجاعوصف قصير
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();

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.


addMarker(latitude, longitude)

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

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

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


addMarker(address)

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

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

المعلمات

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

الإرجاع

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

المعلمات

الاسمالنوعالوصف
latitudeNumberتمثّل هذه السمة خط العرض للنقطة.
longitudeNumberتمثّل هذه السمة خط الطول للنقطة.

الإرجاع

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)

المعلمات

الاسمالنوعالوصف
latitudeNumberتمثّل هذه السمة خط العرض للنقطة.
longitudeNumberتمثّل هذه السمة خط الطول للنقطة.

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


addVisible(address)

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

// Creates a map where New York and Boston are visible.
var 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.
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 التي تم إنشاؤها حديثًا أكثر صرامة مؤقتًا. حصصها.

المعلمات

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

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


setCenter(address)

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

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

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


setLanguage(language)

لضبط اللغة المراد استخدامها للنص على الخريطة (في حال توفّر هذه الميزة).

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

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


setMapType(mapType)

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

// Creates a satellite map.
var 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".
var 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.
var 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.
var 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.
var map = Maps.newStaticMap().setSize(400, 300);

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا


setZoom(zoom)

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

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

المعلمات

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

الإرجاع

StaticMap — هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.

انظر أيضًا