تسمح بإنشاء صور خريطة ثابتة وتزيينها.
يوضح المثال أدناه كيف يمكنك استخدام هذا الصف لإنشاء خريطة لمنطقة مسرح مدينة نيويورك، بما في ذلك محطات القطار القريبة، وعرضها في تطبيق ويب بسيط.
// 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 | تعيين مركز الخريطة باستخدام نقطة (خط العرض/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. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة مؤقتًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
contentType | String | نوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا. |
استرجاع الكرة
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 لصورة الخريطة
setCenter(latitude, longitude)
تعيين مركز الخريطة باستخدام نقطة (خط العرض/lng).
// Creates a map centered on Times Square, using its coordinates. var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Integer | عرض الصورة بالبكسل. |
height | Integer | ارتفاع الصورة بالبكسل. |
استرجاع الكرة
StaticMap
- مثيل الخريطة هذا للتسلسل.
يمكن أيضًا مراجعة
setZoom(zoom)
تعيين عامل التكبير/التصغير، أو مستوى التكبير المستخدم للخريطة.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
zoom | Integer | قيمة تتراوح من صفر إلى 21 شاملة. |
استرجاع الكرة
StaticMap
- مثيل الخريطة هذا للتسلسل.