Class 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لإضافة محدّد إلى الخريطة باستخدام نقطة (lat/lng).
addMarker(address)StaticMapلإضافة محدّد إلى الخريطة باستخدام عنوان.
addPath(points)StaticMapلإضافة مسار إلى الخريطة باستخدام مجموعة من النقاط.
addPath(polyline)StaticMapتضيف مسارًا إلى الخريطة باستخدام خط متعدد مشفر.
addPoint(latitude, longitude)StaticMapلإضافة نقطة جديدة (lat/lng) إلى تعريف المسار الحالي.
addVisible(latitude, longitude)StaticMapتعمل هذه الميزة على إضافة موقع جغرافي (نقطة خطوط الطول/العرض) يجب أن يكون مرئيًا على الخريطة.
addVisible(address)StaticMapتعمل هذه الميزة على إضافة موقع عنوان يجب أن يكون مرئيًا على الخريطة.
beginPath()StaticMapيبدأ تعريف مسار جديد.
clearMarkers()StaticMapيؤدي إلى محو المجموعة الحالية من العلامات.
clearPaths()StaticMapمحو المجموعة الحالية من المسارات
clearVisibles()StaticMapيؤدي إلى محو المجموعة الحالية من المواقع الجغرافية المرئية.
endPath()StaticMapتُكمِل تعريف المسار الذي يبدأ بـ startPath().
getAs(contentType)Blobعرض البيانات داخل هذا العنصر ككائن ثنائي كبير (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)

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

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

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

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

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "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' صالح أيضًا.

تذكرة ذهاب وعودة

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 لصورة الخريطة.


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

راجع أيضًا