تسمح بإنشاء صور خريطة ثابتة وتزيينها.
يوضح المثال أدناه كيف يمكنك استخدام هذا الصف لإنشاء خريطة لمسرح مدينة نيويورك المنطقة، بما في ذلك محطات القطار القريبة، وعرضها في تطبيق ويب بسيط.
// 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();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
address | String | عنوان تريد إضافته. |
الإرجاع
StaticMap
— هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.
addMarker(latitude, longitude)
لإضافة علامة إلى الخريطة باستخدام نقطة (خط الطول/خط العرض).
// Creates a map and adds a marker at the specified coordinates. var 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. var 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. var 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. var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]); var map = Maps.newStaticMap().addPath(polyline);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
polyline | String | خط متعدد مرمّز |
الإرجاع
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();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للنقطة. |
longitude | Number | تمثّل هذه السمة خط الطول للنقطة. |
الإرجاع
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)
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | تمثّل هذه السمة خط العرض للنقطة. |
longitude | Number | تمثّل هذه السمة خط الطول للنقطة. |
الإرجاع
StaticMap
— هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.
انظر أيضًا
addVisible(address)
لإضافة موقع عنوان يجب أن يكون مرئيًا في الخريطة
// Creates a map where New York and Boston are visible. var 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. 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 التي تم إنشاؤها حديثًا أكثر صرامة مؤقتًا. حصصها.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
contentType | String | نوع 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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
latitude | Number | خط العرض للوسط. |
longitude | Number | خط الطول للوسط. |
الإرجاع
StaticMap
— هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.
انظر أيضًا
setCenter(address)
لضبط وسط الخريطة باستخدام عنوان.
// Creates a map centered on Times Square, using its address. var 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". var 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. var 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". var 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. var 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. var 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. var map = Maps.newStaticMap().setSize(400, 300);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
width | Integer | عرض الصورة بالبكسل. |
height | Integer | ارتفاع الصورة بالبكسل. |
الإرجاع
StaticMap
— هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.
انظر أيضًا
setZoom(zoom)
لضبط عامل التكبير/التصغير، أو مستوى التكبير المستخدم للخريطة.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
zoom | Integer | قيمة من صفر إلى 21، بشكل شامل. |
الإرجاع
StaticMap
— هذه النسخة الافتراضية من الخريطة، مخصصة للتسلسل.