يسمح بإنشاء صور خرائط ثابتة وتزيينها.
يوضِّح المثال التالي كيفية استخدام هذه الفئة لإنشاء خريطة لحي المسارح في مدينة نيويورك، بما في ذلك محطات القطار المجاورة، وعرضها في تطبيق ويب بسيط.
// 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 | تُضيف علامة إلى الخريطة باستخدام نقطة (lat/lng). |
addMarker(address) | StaticMap | تُضيف علامة إلى الخريطة باستخدام عنوان. |
addPath(points) | StaticMap | تُضيف مسارًا إلى الخريطة باستخدام صفيف من النقاط. |
addPath(polyline) | StaticMap | تُضيف مسارًا إلى الخريطة باستخدام خط متعدد الأضلاع مشفَّر. |
addPoint(latitude, longitude) | StaticMap | تُضيف نقطة جديدة (lat/lng) إلى تعريف المسار الحالي. |
addVisible(latitude, longitude) | StaticMap | تُضيف نقطة موقع (lat/lng) يجب أن تكون مرئية في الخريطة. |
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 | تُستخدَم لضبط مركز الخريطة باستخدام نقطة (lat/lng). |
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();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
address | String | عنوان تريد إضافته |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
addMarker(latitude, longitude)
تُضيف علامة إلى الخريطة باستخدام نقطة (lat/lng).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | خط العرض للعلامة الجديدة. |
longitude | Number | خط الطول للعلامة الجديدة. |
الإرجاع
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');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
address | String | العنوان الذي سيتم وضع العلامة الجديدة عليه |
الإرجاع
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, ]);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
points | Number[] | مصفوفة من أزواج خطوط العرض/خطوط الطول التي تحدّد المسار |
الإرجاع
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
polyline | String | خط متعدد مُشفَّر |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
addPoint(latitude, longitude)
تُضيف نقطة جديدة (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();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | خط العرض للنقطة |
longitude | Number | خط الطول للنقطة |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
addVisible(latitude, longitude)
تُضيف نقطة موقع (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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | خط العرض للنقطة |
longitude | Number | خط الطول للنقطة |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
addVisible(address)
تُضيف موقعًا جغرافيًا لعنوان يجب أن يكون مرئيًا في الخريطة.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
address | String | عنوان يجب أن يكون مرئيًا في الخريطة |
الإرجاع
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 التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
contentType | String | نوع 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: عنوان URL لصورة الخريطة.
setCenter(latitude, longitude)
تُستخدَم لضبط مركز الخريطة باستخدام نقطة (lat/lng).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | خط العرض للمركز |
longitude | Number | خط الطول للمركز |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setCenter(address)
لضبط مركز الخريطة باستخدام عنوان.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
address | String | عنوان المركز |
الإرجاع
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, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
imageUrl | String | تُحدِّد عنوان URL لاستخدامه كرمز مخصّص للعلامة. يمكن أن تكون الصور بتنسيق PNG أو JPEG أو GIF، ولكن ننصح باستخدام تنسيق PNG. |
useShadow | Boolean | يشير ذلك إلى أنّه يجب إنشاء ظل للعلامة استنادًا إلى المنطقة المرئية من الصورة ومستوى شفافيتها أو عتمتها. |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setFormat(format)
setLanguage(language)
لضبط اللغة التي سيتم استخدامها للنص على الخريطة (حيثما كان ذلك متاحًا).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
language | String | معرّف لغة BCP-47 |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setMapType(mapType)
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', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
size | String | قيمة ثابتة من MarkerSize |
color | String | سلسلة بتنسيق 0xrrggbb أو قيمة ثابتة من Color |
label | String | سلسلة تحتوي على حرف واحد من A إلى Z أو من 0 إلى 9 |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setMobile(useMobileTiles)
لضبط ما إذا كان سيتم استخدام مجموعات مربّعات مخصّصة للأجهزة الجوّالة أم لا
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
useMobileTiles | Boolean | ما إذا كان سيتم استخدام شاشات المعلومات المخصّصة للأجهزة الجوّالة أم لا |
الإرجاع
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', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
weight | Integer | عرض الخطوط بالبكسل |
color | String | لون الخط، كسلسلة بتنسيق 0xrrggbb أو قيمة ثابتة من
Color . |
fillColor | String | لون التعبئة، أو سلسلة بتنسيق 0xrrggbb أو قيمة ثابتة من
Color . |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setSize(width, height)
تُستخدَم لضبط عرض صورة الخريطة وارتفاعها بالبكسل.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
width | Integer | عرض الصورة بالبكسل |
height | Integer | ارتفاع الصورة بالبكسل |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.
انظر أيضًا
setZoom(zoom)
لضبط عامل التكبير أو مستوى التكبير المستخدَم للخريطة
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
zoom | Integer | قيمة من صفر إلى 21، شاملة |
الإرجاع
StaticMap
- مثيل الخريطة هذا، لتسلسل العناصر.