تتيح إنشاء صور خرائط ثابتة وتزيينها.
يوضّح المثال أدناه كيفية استخدام هذه الفئة لإنشاء خريطة لحي المسارح في مدينة نيويورك، بما في ذلك محطات القطار القريبة، وعرضها في تطبيق ويب بسيط.
// 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`;
انظر أيضًا
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
add | Static | تضيف هذه السمة عنوانًا جديدًا إلى تعريف المسار الحالي. |
add | Static | تضيف هذه الطريقة علامة إلى الخريطة باستخدام نقطة (خط العرض/خط الطول). |
add | Static | تضيف هذه الطريقة علامة إلى الخريطة باستخدام عنوان. |
add | Static | تضيف هذه الطريقة مسارًا إلى الخريطة باستخدام مجموعة من النقاط. |
add | Static | تضيف هذه الطريقة مسارًا إلى الخريطة باستخدام خطوط متعدّدة مرمّزة. |
add | Static | تضيف هذه السمة نقطة جديدة (خط العرض/خط الطول) إلى تعريف المسار الحالي. |
add | Static | تضيف هذه السمة موقعًا جغرافيًا (خط العرض/خط الطول) يجب أن يكون مرئيًا في الخريطة. |
add | Static | تضيف هذه السمة موقعًا جغرافيًا للعنوان يجب أن يكون مرئيًا على الخريطة. |
begin | Static | يبدأ تعريف مسار جديدًا. |
clear | Static | يمحو مجموعة العلامات الحالية. |
clear | Static | محو مجموعة المسارات الحالية |
clear | Static | يمحو مجموعة المواقع الجغرافية المرئية الحالية. |
end | Static | تُكمل هذه الطريقة تعريف مسار بدأ باستخدام beginPath(). |
get | Blob | لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد |
get | Blob | تعرض هذه السمة بيانات الصورة كـ Blob. |
get | Byte[] | تعرض بيانات الصورة الأولية كمصفوفة بايت. |
get | String | تعرض هذه السمة عنوان URL لصورة الخريطة. |
set | Static | تضبط هذه السمة مركز الخريطة باستخدام نقطة (خط العرض/خط الطول). |
set | Static | تضبط هذه السمة مركز الخريطة باستخدام عنوان. |
set | Static | تضبط هذه السمة صورة العلامة المخصّصة التي سيتم استخدامها عند إنشاء علامات جديدة. |
set | Static | تضبط هذه السمة تنسيق صورة الخريطة. |
set | Static | تضبط هذه السمة اللغة التي سيتم استخدامها للنص على الخريطة (حيثما كان ذلك متاحًا). |
set | Static | تضبط هذه السمة نوع الخريطة المطلوب عرضها. |
set | Static | تضبط هذه السمة نمط العلامة الذي سيتم استخدامه عند إنشاء علامات جديدة. |
set | Static | تضبط هذه السمة ما إذا كان سيتم استخدام مجموعات مربّعات متخصّصة للأجهزة الجوّالة أم لا. |
set | Static | تضبط هذه السمة نمط المسار الذي سيتم استخدامه عند إنشاء مسارات جديدة. |
set | Static | تضبط هذه السمة عرض صورة الخريطة وارتفاعها بالبكسل. |
set | Static | تضبط هذه السمة عامل التكبير أو مستوى التكبير المستخدَم للخريطة. |
مستندات تفصيلية
add Address(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 | عنوان لإضافته |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
add Marker(latitude, longitude)
تضيف هذه الطريقة علامة إلى الخريطة باستخدام نقطة (خط العرض/خط الطول).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للعلامة الجديدة. |
longitude | Number | خط طول العلامة الجديدة. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
add Marker(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 | العنوان الذي سيتم وضع العلامة الجديدة فيه |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
add Path(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[] | مصفوفة من أزواج خطوط العرض/الطول التي تحدّد المسار |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
add Path(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 | خطوط متعدّدة مرمّزة |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
add Point(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();
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للنقطة. |
longitude | Number | تمثّل هذه السمة خط الطول للنقطة. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
add Visible(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);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للنقطة. |
longitude | Number | تمثّل هذه السمة خط الطول للنقطة. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
add Visible(address)
تضيف هذه السمة موقعًا جغرافيًا للعنوان يجب أن يكون مرئيًا على الخريطة.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
address | String | عنوان يجب أن يكون مرئيًا في الخريطة. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
begin Path()
يبدأ تعريف مسار جديدًا. تحدّد طلبات add وadd كل رأس جديد في المسار. يكتمل المسار عند استدعاء end.
// 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();
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
clear Markers()
يمحو مجموعة العلامات الحالية.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
clear Paths()
محو مجموعة المسارات الحالية
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
clear Visibles()
يمحو مجموعة المواقع الجغرافية المرئية الحالية.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
end Path()
تُكمل هذه الطريقة تعريف مسار بدأ باستخدام 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();
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
get As(contentType)
لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، مثل "myfile.pdf". ومع ذلك، يفترض هذا الخيار أنّ الجزء من اسم الملف الذي يلي النقطة الأخيرة (إن وُجدت) هو امتداد حالي يجب استبداله. وبالتالي، يصبح اسم الملف "ShoppingList.12.25.2014" هو "ShoppingList.12.25.pdf".
للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا لحصص أكثر صرامة بشكل مؤقت.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
content | String | نوع MIME الذي سيتم التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا. بالنسبة إلى مستند Google، يكون 'text/markdown' صالحًا أيضًا. |
الإرجاع
Blob: البيانات ككائن ثنائي كبير.
get Blob()
تعرض هذه السمة بيانات الصورة كـ 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: صورة للخريطة بتنسيق الصورة المحدّد
get Map Image()
تعرض بيانات الصورة الأولية كمصفوفة بايت.
بشكل عام، ننصحك باستخدام get الذي يتيح تفاعلات أبسط مع الخدمات الأخرى.
// 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[]: صورة للخريطة بتنسيق الصورة المحدّد
get Map Url()
تعرض هذه السمة عنوان 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 لصورة الخريطة.
set Center(latitude, longitude)
تضبط هذه السمة مركز الخريطة باستخدام نقطة (خط العرض/خط الطول).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للمركز. |
longitude | Number | تمثّل هذه السمة خط الطول للموقع الجغرافي الذي يقع فيه النشاط التجاري. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Center(address)
تضبط هذه السمة مركز الخريطة باستخدام عنوان.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
address | String | تمثّل هذه السمة عنوان المركز. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Custom Marker Style(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, );
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
image | String | تحدّد هذه السمة عنوان URL لاستخدامه كرمز مخصّص للعلامة. يمكن أن تكون الصور بتنسيق PNG أو JPEG أو GIF، ولكن يُنصح باستخدام تنسيق PNG. |
use | Boolean | تشير إلى أنّه يجب إنشاء ظل للعلامة استنادًا إلى المنطقة المرئية من الصورة ودرجة التعتيم/الشفافية. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Format(format)
set Language(language)
تضبط هذه السمة اللغة التي سيتم استخدامها للنص على الخريطة (حيثما كان ذلك متاحًا).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
language | String | معرّف لغة BCP-47 |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Map Type(mapType)
set Marker Style(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 | قيمة ثابتة من Marker |
color | String | سلسلة بالتنسيق "0xrrggbb" أو قيمة ثابتة من Color |
label | String | سلسلة تحتوي على حرف واحد من A إلى Z أو من 0 إلى 9. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Mobile(useMobileTiles)
تضبط هذه السمة ما إذا كان سيتم استخدام مجموعات مربّعات متخصّصة للأجهزة الجوّالة أم لا.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
use | Boolean | تحديد ما إذا كان سيتم استخدام مربّعات متوافقة مع الأجهزة الجوّالة أم لا |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
set Path Style(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. |
fill | String | لون التعبئة، وهو سلسلة بالتنسيق "0xrrggbb" أو قيمة ثابتة من
Color. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Size(width, height)
تضبط هذه السمة عرض صورة الخريطة وارتفاعها بالبكسل.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
width | Integer | تمثّل هذه السمة عرض الصورة بالبكسل. |
height | Integer | تمثّل هذه السمة ارتفاع الصورة بالبكسل. |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل
انظر أيضًا
set Zoom(zoom)
تضبط هذه السمة عامل التكبير أو مستوى التكبير المستخدَم للخريطة.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
zoom | Integer | قيمة تتراوح بين صفر و21، بما في ذلك هذان الرقمان |
الإرجاع
Static: مثيل الخريطة هذا، للتسلسل