Maps Service

خرائط Google

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

صفوف

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

Avoid

أماكن إقامة

الموقعالنوعالوصف
TOLLSEnumتجنَّب رسوم العبور.
HIGHWAYSEnumتجنَّب الطرق السريعة.

Color

أماكن إقامة

الموقعالنوعالوصف
BLACKEnum
BROWNEnum
GREENEnum
PURPLEEnum
YELLOWEnum
BLUEEnum
GRAYEnum
ORANGEEnum
REDEnum
WHITEEnum

DirectionFinder

الطُرق

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

DirectionFinderEnums

أماكن إقامة

الموقعالنوعالوصف
AvoidAvoid
ModeMode

ElevationSampler

الطُرق

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

Format

أماكن إقامة

الموقعالنوعالوصف
PNGEnumتنسيق PNG بسعة 8 بت
PNG8Enumتنسيق PNG بسعة 8 بت
PNG32Enumتنسيق PNG بسعة 32 بت
GIFEnumتنسيق GIF
JPGEnumتنسيق JPEG
JPG_BASELINEEnumتنسيق JPEG غير التدرّجي

Geocoder

الطُرق

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

Maps

أماكن إقامة

الموقعالنوعالوصف
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
decodePolyline(polyline)Number[]فك ترميز سلسلة مخطّط متعدد الأضلاع مشفّرة إلى مصفوفة من النقاط.
encodePolyline(points)Stringترميز صفيف من النقاط في سلسلة
newDirectionFinder()DirectionFinderتُنشئ عنصر DirectionFinder جديدًا.
newElevationSampler()ElevationSamplerلإنشاء كائن ElevationSampler
newGeocoder()Geocoderلإنشاء عنصر Geocoder جديد.
newStaticMap()StaticMapلإنشاء عنصر StaticMap جديد.
setAuthentication(clientId, signingKey)voidيتيح استخدام حساب خطة Google Maps APIs Premium تم إنشاؤه خارجيًا، للاستفادة من حصة إضافية ممنوحة.

MarkerSize

أماكن إقامة

الموقعالنوعالوصف
TINYEnumالأسواق الصغيرة الحجم (أصغر حجم متاح)
MIDEnumعلامات متوسطة الحجم (أكبر علامة متاحة)
SMALLEnumعلامات صغيرة الحجم

Mode

أماكن إقامة

الموقعالنوعالوصف
DRIVINGEnumاتجاهات القيادة عبر الطرق
WALKINGEnumالاتجاهات للمشي عبر مسارات المشاة والأرصفة (حيثما كان ذلك متاحًا)
BICYCLINGEnumاتجاهات ركوب الدراجات عبر المسارات المخصّصة للدراجات والشوارع المفضّلة (حيثما كان ذلك متاحًا)
TRANSITEnumاتجاهات النقل العام عبر مسارات النقل العام (حيثما كان ذلك متاحًا)

StaticMap

الطُرق

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

StaticMapEnums

أماكن إقامة

الموقعالنوعالوصف
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

أماكن إقامة

الموقعالنوعالوصف
ROADMAPEnumخريطة طريق عادية، كما تظهر عادةً على الموقع الإلكتروني لخدمة "خرائط Google"
SATELLITEEnumخريطة القمر الصناعي
TERRAINEnumخريطة طبوغرافية تعرض التضاريس والنباتات
HYBRIDEnumخريطة مختلطة من خرائط القمر الصناعي وخريطة الطريق، تعرض طبقة شفافة للشوارع الرئيسية وأسماء الأماكن على خريطة القمر الصناعي