Maps Service

تسمح هذه الخدمة للنصوص البرمجية بإنشاء خرائط ثابتة، والعثور على الاتجاهات، وتحويل العناوين إلى إحداثيات ترميز جغرافي، وأخذ عيّنات من الارتفاعات.

الدروس

الاسم	وصف قصير
`Avoid`	تعداد يمثّل أنواع القيود التي يجب تجنُّبها عند البحث عن الاتجاهات.
`Color`	تعداد يمثّل الألوان المسماة المتاحة للاستخدام في صور الخرائط.
`DirectionFinder`	يسمح هذا الإذن باسترداد الاتجاهات بين المواقع الجغرافية.
`DirectionFinderEnums`	مجموعة من التعدادات التي يستخدمها `DirectionFinder`
`ElevationSampler`	تسمح بأخذ عيّنات من الارتفاعات في مواقع جغرافية معيّنة.
`Format`	تعداد يمثّل تنسيق صورة الخريطة.
`Geocoder`	تتيح هذه السمة التحويل بين العنوان والإحداثيات الجغرافية.
`Maps`	تتيح هذه الخدمة العثور على الاتجاهات، والترميز الجغرافي، وأخذ عيّنات من الارتفاع، وإنشاء صور ثابتة للخرائط.
`MarkerSize`	تعداد يمثّل حجم علامة تمت إضافتها إلى خريطة.
`Mode`	تعداد يمثّل وسيلة التنقّل المطلوب استخدامها عند البحث عن الاتجاهات.
`StaticMap`	تتيح إنشاء صور خرائط ثابتة وتزيينها.
`StaticMapEnums`	مجموعة من التعدادات التي يستخدمها `StaticMap`
`Type`	تعداد يمثّل نوع الخريطة المطلوب عرضها.

`Avoid`

الخصائص

الموقع	النوع	الوصف
`TOLLS`	`Enum`	تجنُّب رسوم العبور
`HIGHWAYS`	`Enum`	تجنُّب الطرق السريعة

`Color`

الخصائص

الموقع	النوع	الوصف
`BLACK`	`Enum`
`BROWN`	`Enum`
`GREEN`	`Enum`
`PURPLE`	`Enum`
`YELLOW`	`Enum`
`BLUE`	`Enum`
`GRAY`	`Enum`
`ORANGE`	`Enum`
`RED`	`Enum`
`WHITE`	`Enum`

`DirectionFinder`

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
`addWaypoint(latitude, longitude)`	`DirectionFinder`	تضيف هذه السمة نقطة طريق يجب أن يمرّ بها المسار، وذلك باستخدام نقطة (خط العرض/خط الطول).
`addWaypoint(address)`	`DirectionFinder`	تضيف هذه السمة نقطة مرور يجب أن يمرّ بها المسار، وذلك باستخدام عنوان.
`clearWaypoints()`	`DirectionFinder`	يمحو مجموعة نقاط الطريق الحالية.
`getDirections()`	`Object`	يحصل على الاتجاهات باستخدام نقطة البداية والوجهة والخيارات الأخرى التي تم ضبطها.
`setAlternatives(useAlternatives)`	`DirectionFinder`	تُحدّد ما إذا كان يجب عرض طرق بديلة بدلاً من الطريق الأعلى ترتيبًا فقط (القيمة التلقائية هي `false`).
`setArrive(time)`	`DirectionFinder`	تضبط هذه السمة الوقت المطلوب للوصول (عند الاقتضاء).
`setAvoid(avoid)`	`DirectionFinder`	تحدّد هذه السمة ما إذا كان سيتم تجنُّب أنواع معيّنة من القيود.
`setDepart(time)`	`DirectionFinder`	تضبط هذه السمة وقت المغادرة المطلوب (عند الاقتضاء).
`setDestination(latitude, longitude)`	`DirectionFinder`	تضبط هذه السمة الموقع الجغرافي النهائي الذي سيتم حساب الاتجاهات إليه، وذلك باستخدام نقطة (خط العرض/خط الطول).
`setDestination(address)`	`DirectionFinder`	تضبط هذه السمة الموقع الجغرافي النهائي الذي سيتم احتساب الاتجاهات إليه باستخدام عنوان.
`setLanguage(language)`	`DirectionFinder`	تضبط هذه السمة اللغة التي سيتم استخدامها في الاتجاهات.
`setMode(mode)`	`DirectionFinder`	تُحدِّد هذه السمة وسيلة النقل (تكون القيادة هي الخيار التلقائي).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	تحدّد هذه السمة ما إذا كان سيتم تحسين المسار المقدَّم من خلال إعادة ترتيب نقاط الطريق بترتيب أكثر فعالية (القيمة التلقائية هي `false`).
`setOrigin(latitude, longitude)`	`DirectionFinder`	تضبط هذه السمة الموقع الجغرافي الذي سيتم منه حساب الاتجاهات، وذلك باستخدام نقطة (خط العرض/خط الطول).
`setOrigin(address)`	`DirectionFinder`	تضبط هذه السمة الموقع الجغرافي الذي سيتم منه احتساب الاتجاهات، وذلك باستخدام عنوان.
`setRegion(region)`	`DirectionFinder`	تضبط هذه السمة منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية.

`DirectionFinderEnums`

الخصائص

الموقع	النوع	الوصف
`Avoid`	`Avoid`
`Mode`	`Mode`

`ElevationSampler`

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
`sampleLocation(latitude, longitude)`	`Object`	تعرض هذه الطريقة بيانات الارتفاع لنقطة واحدة (خط العرض/خط الطول).
`sampleLocations(points)`	`Object`	تعرض هذه الطريقة بيانات الارتفاع لسلسلة من النقاط (خطوط الطول والعرض).
`sampleLocations(encodedPolyline)`	`Object`	تعرض هذه الطريقة بيانات الارتفاع للنقاط في خط متعدد الأضلاع مشفّر.
`samplePath(points, numSamples)`	`Object`	تعرض هذه الطريقة بيانات الارتفاع لعدد من العيّنات على طول خط، ويتم تحديدها باستخدام سلسلة من النقاط.
`samplePath(encodedPolyline, numSamples)`	`Object`	تعرض هذه الطريقة بيانات الارتفاع لعدد من العيّنات على طول خط، ويتم تحديد هذا الخط باستخدام خط متعدد الأضلاع مشفّر.

`Format`

الخصائص

الموقع	النوع	الوصف
`PNG`	`Enum`	تنسيق PNG ذو 8 بت
`PNG8`	`Enum`	تنسيق PNG ذو 8 بت
`PNG32`	`Enum`	تنسيق PNG‏ 32 بت
`GIF`	`Enum`	تنسيق GIF
`JPG`	`Enum`	تنسيق JPEG
`JPG_BASELINE`	`Enum`	تنسيق JPEG غير متدرّج

`Geocoder`

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
`geocode(address)`	`Object`	تعرض هذه الطريقة النقاط الجغرافية التقريبية لعنوان معيّن.
`reverseGeocode(latitude, longitude)`	`Object`	تعرض هذه الطريقة العناوين التقريبية لنقطة جغرافية معيّنة.
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	تضبط هذه السمة حدود منطقة يجب منحها أولوية إضافية في النتائج.
`setLanguage(language)`	`Geocoder`	تضبط هذه السمة اللغة التي سيتم استخدامها في النتائج.
`setRegion(region)`	`Geocoder`	تضبط هذه السمة منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية.

`Maps`

الخصائص

الموقع	النوع	الوصف
`DirectionFinder`	`DirectionFinderEnums`
`StaticMap`	`StaticMapEnums`

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
`decodePolyline(polyline)`	`Number[]`	تفكّ هذه الدالة ترميز سلسلة خطوط متعدّدة الأضلاع مُرمّزة وتحوّلها إلى مصفوفة من النقاط.
`encodePolyline(points)`	`String`	ترميز مصفوفة من النقاط في سلسلة
`newDirectionFinder()`	`DirectionFinder`	تُنشئ هذه الدالة عنصر DirectionFinder جديدًا.
`newElevationSampler()`	`ElevationSampler`	تُنشئ هذه الدالة كائن ElevationSampler.
`newGeocoder()`	`Geocoder`	تُنشئ هذه الدالة عنصر Geocoder جديدًا.
`newStaticMap()`	`StaticMap`	تُنشئ هذه الدالة عنصر StaticMap جديدًا.
`resetAuthenticationApiKey()`	`void`	تعيد هذه الطريقة ضبط بيانات اعتماد المصادقة لاستخدام حدود الحصة التلقائية.
`setAuthenticationByApiKey(apiKey)`	`void`	تتيح استخدام مفتاح واجهة برمجة التطبيقات لمصادقة الطلبات من أجل الاستفادة من حصص إضافية.
`setAuthenticationByApiKey(apiKey, signingKey)`	`void`	يتيح استخدام مفتاح واجهة برمجة التطبيقات ومفتاح التوقيع لمصادقة الطلبات من أجل الاستفادة من حصص إضافية في StaticMap.

`MarkerSize`

الخصائص

الموقع	النوع	الوصف
`TINY`	`Enum`	الأسواق الصغيرة جدًا (أصغر الأسواق المتاحة)
`MID`	`Enum`	علامات متوسطة الحجم (الأكبر حجمًا).
`SMALL`	`Enum`	علامات صغيرة الحجم

`Mode`

الخصائص

الموقع	النوع	الوصف
`DRIVING`	`Enum`	اتجاهات القيادة عبر الطرق
`WALKING`	`Enum`	اتجاهات المشي عبر مسارات المشاة والأرصفة (حيثما توفّرت)
`BICYCLING`	`Enum`	اتجاهات الدراجات عبر المسارات المخصّصة للدراجات والشوارع المفضّلة (حيثما توفّرت)
`TRANSIT`	`Enum`	اتجاهات النقل العام عبر مسارات النقل العام (حيثما توفّرت)

`StaticMap`

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
`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`	تضبط هذه السمة عامل التكبير أو مستوى التكبير المستخدَم للخريطة.

`StaticMapEnums`

الخصائص

الموقع	النوع	الوصف
`Color`	`Color`
`Format`	`Format`
`MarkerSize`	`MarkerSize`
`Type`	`Type`

`Type`

الخصائص

الموقع	النوع	الوصف
`ROADMAP`	`Enum`	خريطة طريق عادية، كما تظهر عادةً على موقع "خرائط Google" الإلكتروني
`SATELLITE`	`Enum`	خريطة القمر الصناعي
`TERRAIN`	`Enum`	خريطة تضاريس مادية تعرض التضاريس والنباتات
`HYBRID`	`Enum`	هي مزيج من خرائط القمر الصناعي وخرائط الطرق، وتعرض طبقة شفافة من الشوارع الرئيسية وأسماء الأماكن على خريطة القمر الصناعي.

Maps Service تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الدروس

الخصائص

الخصائص

الطُرق

الخصائص

الطُرق

الخصائص

الطُرق

الخصائص

الطُرق

الخصائص

الخصائص

الطُرق

الخصائص

الخصائص

Maps Service