Class 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تضيف هذه الطريقة علامة إلى الخريطة باستخدام نقطة (خط العرض/خط الطول).
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تُكمل هذه الطريقة تعريف مسار بدأ باستخدام beginPath().
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.
const 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.
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)

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

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

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

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


setCenter(latitude, longitude)

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

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

انظر أيضًا