Maps Service

الخرائط

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

صفوف

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

Avoid

أماكن إقامة

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

Color

أماكن إقامة

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

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لتعيين موقع النهاية الذي يتم حساب الاتجاهات إليه، باستخدام نقطة (خط العرض/lng).
setDestination(address)DirectionFinderلتعيين موقع النهاية المطلوب حساب الاتجاهات إليه، باستخدام عنوان.
setLanguage(language)DirectionFinderلتعيين اللغة التي سيتم استخدامها للاتجاهات.
setMode(mode)DirectionFinderلتعيين وضع السفر (الإعداد التلقائي هو القيادة).
setOptimizeWaypoints(optimizeOrder)DirectionFinderتحدّد ما إذا كان سيتم تحسين المسار المقدّم أم لا من خلال إعادة ترتيب نقاط الطريق بترتيب أكثر فعالية (تكون الإعدادات التلقائية على false).
setOrigin(latitude, longitude)DirectionFinderلتعيين موقع البدء الذي سيتم حساب الاتجاهات منه، باستخدام نقطة (خط الطول/خط العرض).
setOrigin(address)DirectionFinderلضبط موقع البداية الذي سيتم حساب الاتجاهات منه، باستخدام عنوان.
setRegion(region)DirectionFinderتتيح هذه السياسة ضبط منطقة لاستخدامها عند تفسير أسماء المواقع الجغرافية.

DirectionFinderEnums

أماكن إقامة

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

ElevationSampler

الطُرق

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

Format

أماكن إقامة

الموقعTypeالوصف
PNGEnumتنسيق PNG 8 بت.
PNG8Enumتنسيق PNG 8 بت.
PNG32Enumتنسيق PNG 32 بت.
GIFEnumGIF.
JPGEnumJPEG.
JPG_BASELINEEnumتنسيق JPEG غير تدريجي

Geocoder

الطُرق

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

Maps

أماكن إقامة

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

الطُرق

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

MarkerSize

أماكن إقامة

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

Mode

أماكن إقامة

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

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تُكمل تعريف مسار يبدأ بـ 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تعيين عامل التكبير/التصغير، أو مستوى التكبير المستخدم للخريطة.

StaticMapEnums

أماكن إقامة

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

Type

أماكن إقامة

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