الفرق بين المراجعتين ل"Cordova/cordova plugin geolocation"
جميل-بيلوني (نقاش | مساهمات) ط |
(تحديث) |
||
سطر 12: | سطر 12: | ||
ليس هناك ما يضمن أن تعيد الواجهةُ البرمجية الموقعَ الفعلي للجهاز. لمعرفة كيفية استخدام هذه الإضافة، اطلع على الأمثلة التوضيحية في نهاية هذه الصفحة. | ليس هناك ما يضمن أن تعيد الواجهةُ البرمجية الموقعَ الفعلي للجهاز. لمعرفة كيفية استخدام هذه الإضافة، اطلع على الأمثلة التوضيحية في نهاية هذه الصفحة. | ||
__TOC__ | __TOC__ | ||
− | تأسست الواجهة البرمجية لهذه الإضافة على [http://dev.w3.org/geo/api/spec-source.html مواصفات الواجهة البرمجية لتحديد المواقع الجغرافية (W3C)] ، ولا تُنفّذ إلا على الأجهزة التي لا توفر تنفيذًا (implementation) جاهزًا لها مسبقًا. | + | تأسست الواجهة البرمجية لهذه الإضافة على [http://dev.w3.org/geo/api/spec-source.html مواصفات الواجهة البرمجية لتحديد المواقع الجغرافية (W3C)] ، ولا تُنفّذ إلا على الأجهزة التي لا توفر تنفيذًا (implementation) جاهزًا لها مسبقًا. |
'''تنبيه''': جمع واستخدام بيانات تحديد الموقع الجغرافي تثير مخاوف بخصوص قضايا الخصوصية. يجب أن تُوضّح [[Cordova/privacy|سياسةُ الخصوصية]] في تطبيقك كيفية استخدام التطبيق لبيانات تحديد الموقع الجغرافي، وما إن كانت ستُتَشارك مع أي أطراف أخرى، ومستوى دقة البيانات (مثل هل المعلومات ستكون تقريبية، أم دقيقة، أم تستهدف الرمز البريدي ZIP، وغير ذلك). عمومًا، تعتبر بيانات تحديد الموقع الجغرافي حسَّاسة، لأنها قد تُستخدم لمعرفة مكان المستخدم، وفي حال تخزينها، فستكشف تاريخ حركاته وسكناته. لذلك، فبالإضافة إلى سياسة خصوصية التطبيق، سيكون من الجيد تقديم إشعار فوري قبل محاولة تطبيقك الوصول إلى بيانات الموقع الجغرافي (إن لم يكن نظام التشغيل يفعل ذلك سلفًا). ينبغي أن يوفر هذا الإشعار نفس المعلومات المذكورة أعلاه، إضافةً إلى استئذان المُستخدم (على سبيل المثال، عبر تقديم خيارات من قبيل "'''حسنًا'''" و "'''لا شكرًا'''"). لمزيد من المعلومات، يرجى الاطلاع على [[Cordova/privacy|دليل الخصوصية]]. | '''تنبيه''': جمع واستخدام بيانات تحديد الموقع الجغرافي تثير مخاوف بخصوص قضايا الخصوصية. يجب أن تُوضّح [[Cordova/privacy|سياسةُ الخصوصية]] في تطبيقك كيفية استخدام التطبيق لبيانات تحديد الموقع الجغرافي، وما إن كانت ستُتَشارك مع أي أطراف أخرى، ومستوى دقة البيانات (مثل هل المعلومات ستكون تقريبية، أم دقيقة، أم تستهدف الرمز البريدي ZIP، وغير ذلك). عمومًا، تعتبر بيانات تحديد الموقع الجغرافي حسَّاسة، لأنها قد تُستخدم لمعرفة مكان المستخدم، وفي حال تخزينها، فستكشف تاريخ حركاته وسكناته. لذلك، فبالإضافة إلى سياسة خصوصية التطبيق، سيكون من الجيد تقديم إشعار فوري قبل محاولة تطبيقك الوصول إلى بيانات الموقع الجغرافي (إن لم يكن نظام التشغيل يفعل ذلك سلفًا). ينبغي أن يوفر هذا الإشعار نفس المعلومات المذكورة أعلاه، إضافةً إلى استئذان المُستخدم (على سبيل المثال، عبر تقديم خيارات من قبيل "'''حسنًا'''" و "'''لا شكرًا'''"). لمزيد من المعلومات، يرجى الاطلاع على [[Cordova/privacy|دليل الخصوصية]]. | ||
سطر 81: | سطر 81: | ||
<syntaxhighlight lang="xml"><edit-config target="NSLocationWhenInUseUsageDescription" file="*-Info.plist" mode="merge"> | <syntaxhighlight lang="xml"><edit-config target="NSLocationWhenInUseUsageDescription" file="*-Info.plist" mode="merge"> | ||
<string>need location access to find things nearby</string> | <string>need location access to find things nearby</string> | ||
− | </edit-config> | + | </edit-config> |
+ | </syntaxhighlight> | ||
====ملاحظات خاصة بمنصة أندرويد ==== | ====ملاحظات خاصة بمنصة أندرويد ==== | ||
سطر 114: | سطر 115: | ||
} | } | ||
// خيارات: إن لم يحدث أي تحديث خلال 30 ثانية، فسيُطلق خطأ | // خيارات: إن لم يحدث أي تحديث خلال 30 ثانية، فسيُطلق خطأ | ||
− | var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });</syntaxhighlight>يستعمل المعامل <code>geolocationOptions</code> لتخصيص عملية تحصيل معلومات الموقع الجغرافي من الكائن <code>Position</code>.<syntaxhighlight lang="javascript">{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };</syntaxhighlight>الخيارات التي يمكن استعمالها مع هذا المعامل هي: | + | var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });</syntaxhighlight> |
+ | |||
+ | === <code>geolocationOptions</code> === | ||
+ | يستعمل المعامل <code>geolocationOptions</code> لتخصيص عملية تحصيل معلومات الموقع الجغرافي من الكائن <code>Position</code>.<syntaxhighlight lang="javascript">{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };</syntaxhighlight>الخيارات التي يمكن استعمالها مع هذا المعامل هي: | ||
* <code>enableHighAccuracy</code>: قيمة منطقية تحدد إن كان تطبيقك يحتاج إلى الحصول على أدق النتائج الممكنة. بشكل افتراضي، يحاول الجهاز تحصيل معلومات الموقع الجغرافي (<code>Position</code>) باستخدام أساليب تستند إلى الشبكة. إنَّ ضبط هذه الخاصية إلى القيمة <code>true</code> سيُخطِر إطار العمل بضرورة استخدام أساليب أكثر دقة، مثل تحديد الموقع عبر الأقمار الصناعية. | * <code>enableHighAccuracy</code>: قيمة منطقية تحدد إن كان تطبيقك يحتاج إلى الحصول على أدق النتائج الممكنة. بشكل افتراضي، يحاول الجهاز تحصيل معلومات الموقع الجغرافي (<code>Position</code>) باستخدام أساليب تستند إلى الشبكة. إنَّ ضبط هذه الخاصية إلى القيمة <code>true</code> سيُخطِر إطار العمل بضرورة استخدام أساليب أكثر دقة، مثل تحديد الموقع عبر الأقمار الصناعية. | ||
* <code>timeout</code>: عدد يحدِّد الفترة الزمنية القصوى (بالميلي ثانية) المسموح بمرورها منذ لحظة استدعاء التابع <code>navigator.geolocation.getCurrentPosition</code> أو <code>geolocation.watchPosition</code> وحتى تنفيذ دالة رد النداء <code>geolocationSuccess</code> المقابلة. إذا لم يتم استدعاء دالة رد النداء <code>geolocationSuccess</code> خلال هذا الوقت، فسيُمرّر إلى دالة الخطأ <code>geolocationError</code> رمز الخطأ <code>PositionError.TIMEOUT</code>. (لاحظ أنّه عند استخدامها مع التابع <code>geolocation.watchPosition</code>، يمكن استدعاء دالة الخطأ <code>geolocationError</code> بشكل متكررٍ كل <code>timeout</code> ميلي ثانية). | * <code>timeout</code>: عدد يحدِّد الفترة الزمنية القصوى (بالميلي ثانية) المسموح بمرورها منذ لحظة استدعاء التابع <code>navigator.geolocation.getCurrentPosition</code> أو <code>geolocation.watchPosition</code> وحتى تنفيذ دالة رد النداء <code>geolocationSuccess</code> المقابلة. إذا لم يتم استدعاء دالة رد النداء <code>geolocationSuccess</code> خلال هذا الوقت، فسيُمرّر إلى دالة الخطأ <code>geolocationError</code> رمز الخطأ <code>PositionError.TIMEOUT</code>. (لاحظ أنّه عند استخدامها مع التابع <code>geolocation.watchPosition</code>، يمكن استدعاء دالة الخطأ <code>geolocationError</code> بشكل متكررٍ كل <code>timeout</code> ميلي ثانية). | ||
سطر 134: | سطر 138: | ||
navigator.geolocation.clearWatch(watchID);</syntaxhighlight> | navigator.geolocation.clearWatch(watchID);</syntaxhighlight> | ||
− | == | + | == كائنات (للقراءة فقط) == |
===<code>Position</code>=== | ===<code>Position</code>=== |
المراجعة الحالية بتاريخ 18:09، 3 ديسمبر 2020
توفر هذه الإضافة معلومات حول الموقع الجغرافي للجهاز، مثل خط العرض وخط الطول.
هناك عدة طرقٍ لتحديد معلومات الموقع الجغرافي منها:
- نظام تحديد المواقع العالمي (GPS)، و
- استنتاج الموقع من إشارات الشبكة، مثل عنوان IP، وعناوين تحديد الهوية بموجات الراديو (RFID)، و
- اللاسلكي (WiFi)، و
- عناوين Bluetooth الفيزيائية (MAC)، و
- مُعرِّفات الشبكة GSM/CDMA.
ليس هناك ما يضمن أن تعيد الواجهةُ البرمجية الموقعَ الفعلي للجهاز. لمعرفة كيفية استخدام هذه الإضافة، اطلع على الأمثلة التوضيحية في نهاية هذه الصفحة.
تأسست الواجهة البرمجية لهذه الإضافة على مواصفات الواجهة البرمجية لتحديد المواقع الجغرافية (W3C) ، ولا تُنفّذ إلا على الأجهزة التي لا توفر تنفيذًا (implementation) جاهزًا لها مسبقًا.
تنبيه: جمع واستخدام بيانات تحديد الموقع الجغرافي تثير مخاوف بخصوص قضايا الخصوصية. يجب أن تُوضّح سياسةُ الخصوصية في تطبيقك كيفية استخدام التطبيق لبيانات تحديد الموقع الجغرافي، وما إن كانت ستُتَشارك مع أي أطراف أخرى، ومستوى دقة البيانات (مثل هل المعلومات ستكون تقريبية، أم دقيقة، أم تستهدف الرمز البريدي ZIP، وغير ذلك). عمومًا، تعتبر بيانات تحديد الموقع الجغرافي حسَّاسة، لأنها قد تُستخدم لمعرفة مكان المستخدم، وفي حال تخزينها، فستكشف تاريخ حركاته وسكناته. لذلك، فبالإضافة إلى سياسة خصوصية التطبيق، سيكون من الجيد تقديم إشعار فوري قبل محاولة تطبيقك الوصول إلى بيانات الموقع الجغرافي (إن لم يكن نظام التشغيل يفعل ذلك سلفًا). ينبغي أن يوفر هذا الإشعار نفس المعلومات المذكورة أعلاه، إضافةً إلى استئذان المُستخدم (على سبيل المثال، عبر تقديم خيارات من قبيل "حسنًا" و "لا شكرًا"). لمزيد من المعلومات، يرجى الاطلاع على دليل الخصوصية.
تعرِّف هذه الإضافة كائنًا عامًّا هو navigator.geolocation
(في المنصات التي لا يكون مُعرّفا فيها).
على الرغم من أنّ هذا الكائن موجود في النطاق العام (global scope)، إلا أنّ الميزات التي يوفرها لن تكون متاحة إلا بعد إطلاق الحدث deviceready
.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("navigator.geolocation works well");
}
التثبيت
تتطلب إضافة تحديد الموقع الجغرافي الإصدارَ كوردوفا 5.0 أوما بعده (الإصدار المستقر الحالي 1.0.0). لتثبيتها، نفذ الأمر التالي:
cordova plugin add cordova-plugin-geolocation
لا يزال بإمكان الإصدارات القديمة من كوردوفا تثبيت هذه الإضافة عبر المُعرِّف المهمل (الإصدار المستقر 0.3.12) بالشكل التالي:
cordova plugin add org.apache.cordova.geolocation
من الممكن أيضًا تثبيت هذه الإضافة عبر عنوان مستودع git مباشرة (إلا أنه غير مستقر):
cordova plugin add https://github.com/apache/cordova-plugin-geolocation.git
المنصات المدعومة
- أندرويد
- iOS
- ويندوز
التوابع
يُعيد هذا التابع الموقع الحالي للجهاز، ويمرّره إلى دالة رد النداء (callback) geolocationSuccess
، مع تمرير الكائن Position
كمعامل. إذا كان هناك خطأ، فسيُمرّر الكائن PositionError
إلى دالة رد النداء geolocationError
.
navigator.geolocation.getCurrentPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);
المعاملات المُمرَّرة إلى التابع هي:
geolocationSuccess
: دالة رد نداء (callback) التي سيُمرّر إليها الموقع الحالي.geolocationError
: (اختياري) دالة رد النداء التي ستُنفَّذ في حالة حدوث خطأ.geolocationOptions
: (اختياري) خيارات تحديد الموقع الجغرافي.
مثال عن استعمال التابع getCurrentPosition
:
// onSuccess دالة رد النداء للحدث
// والذي يحتوي Position يقبل هذا التابع الكائن
// الحالية GPS إحداثيات
//
var onSuccess = function(position) {
alert('Latitude: ' + position.coords.latitude + '\n' +
'Longitude: ' + position.coords.longitude + '\n' +
'Altitude: ' + position.coords.altitude + '\n' +
'Accuracy: ' + position.coords.accuracy + '\n' +
'Altitude Accuracy: ' + position.coords.altitudeAccuracy + '\n' +
'Heading: ' + position.coords.heading + '\n' +
'Speed: ' + position.coords.speed + '\n' +
'Timestamp: ' + position.timestamp + '\n');
};
// PositionError الكائن onError تتلقى دالة الاستجابة للحدث
//
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
navigator.geolocation.getCurrentPosition(onSuccess, onError);
ملاحظات خاصة بمنصة iOS
منذ الإصدار iOS 10، صار من الإلزامي تقديم وصف للاستخدام في الملف info.plist
إن كنت تريد الوصول إلى البيانات الحساسة. عندما يستأذن النظام المستخدم للوصول إلى تلك المعلومات، سيُعرض وصف الاستخدام ذاك كجزء من مربع حوار الاستئذان، ولكن في حال عدم توفير وصف الاستخدام، فسيتعطل التطبيق قبل عرض مربع الحوار. كما سترفض Apple التطبيقات التي تحاول الوصول إلى البيانات الخاصة دون تقديم وصفٍ للاستخدام.
تتطلب هذه الإضافة وصف الاستخدام التالي:
NSLocationWhenInUseUsageDescription
: يحدد سبب سعي التطبيق للوصول إلى موقع المستخدم.
لإضافة هذه المُدخلة إلى info.plist
، يمكنك استخدام الوسم edit-config
في الملف config.xml
على النحو التالي:
<edit-config target="NSLocationWhenInUseUsageDescription" file="*-Info.plist" mode="merge">
<string>need location access to find things nearby</string>
</edit-config>
ملاحظات خاصة بمنصة أندرويد
إذا تم إيقاف خدمة تحديد الموقع الجغرافي، فستُستدعَى دالة رد النداء onError
بعد المدة الزمنية timeout
(إذا تم تحديدها). وفي حال عدم تحديد المعامل timeout
، فلن يتم استدعاء أي دالة رد نداء.
يُعيد هذا التابع الموضع الحالي للجهاز عند رصد أي تغيير في الموضع. عندما يتغير موقع الجهاز، يتم تنفيذ دالة رد النداء geolocationSuccess
مع تمرير الكائن Position
إليها كمعامل. إن حدث خطأ، فستُنفّذ دالة رد النداء geolocationError
مع تمرير الكائن PositionError
كمعامل.
var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
[geolocationError],
[geolocationOptions]);
المعاملات المُمرَّرة إلى التابع هي:
geolocationSuccess
: دالة رد النداء التي سيُمرّر إليها الموقع الحالي.geolocationError
: (اختياري) دالة رد النداء التي ستُنفَّذ عند حدوث خطأ.geolocationOptions
: (اختياري) خيارات تحديد الموقع الجغرافي.
يعيد التابع سلسلة نصية تحتوي على معرفِ المراقبة (watch id)، الذي يحدِّد مجال مراقبة الموقع (watch position interval). يجب استخدام مٌعرّف المراقبة مع التابع navigator.geolocation.clearWatch
لإيقاف مراقبة تغييرات الموقع الجغرافي.
إليك المثال التالي:
// للنجاح onSuccess دالة رد النداء
//الذي يحتوي على Position يقبل هذا التابع الكائن
// الحالية GPS احداثيات
//
function onSuccess(position) {
var element = document.getElementById('geolocation');
element.innerHTML = 'Latitude: ' + position.coords.latitude + '<br />' +
'Longitude: ' + position.coords.longitude + '<br />' +
'<hr />' + element.innerHTML;
}
// PositionError الكائن onError تتلقى دالة رد النداء للخطأ
//
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// خيارات: إن لم يحدث أي تحديث خلال 30 ثانية، فسيُطلق خطأ
var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { timeout: 30000 });
geolocationOptions
يستعمل المعامل geolocationOptions
لتخصيص عملية تحصيل معلومات الموقع الجغرافي من الكائن Position
.
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
الخيارات التي يمكن استعمالها مع هذا المعامل هي:
enableHighAccuracy
: قيمة منطقية تحدد إن كان تطبيقك يحتاج إلى الحصول على أدق النتائج الممكنة. بشكل افتراضي، يحاول الجهاز تحصيل معلومات الموقع الجغرافي (Position
) باستخدام أساليب تستند إلى الشبكة. إنَّ ضبط هذه الخاصية إلى القيمةtrue
سيُخطِر إطار العمل بضرورة استخدام أساليب أكثر دقة، مثل تحديد الموقع عبر الأقمار الصناعية.timeout
: عدد يحدِّد الفترة الزمنية القصوى (بالميلي ثانية) المسموح بمرورها منذ لحظة استدعاء التابعnavigator.geolocation.getCurrentPosition
أوgeolocation.watchPosition
وحتى تنفيذ دالة رد النداءgeolocationSuccess
المقابلة. إذا لم يتم استدعاء دالة رد النداءgeolocationSuccess
خلال هذا الوقت، فسيُمرّر إلى دالة الخطأgeolocationError
رمز الخطأPositionError.TIMEOUT
. (لاحظ أنّه عند استخدامها مع التابعgeolocation.watchPosition
، يمكن استدعاء دالة الخطأgeolocationError
بشكل متكررٍ كلtimeout
ميلي ثانية).maximumAge
: عدد يحدد أقصى عمر (الوقت بالميلي ثانية) للموقع المخزَّن مؤقتًا (cached position) ليتم قبوله.
ملاحظات خاصة بمنصة أندرويد
في حال إيقاف خدمة تحديد الموقع الجغرافي، فستُستدعى دالة رد النداء onError
بعد الفاصل الزمني timeout
في حال تحديده. أما في حال عدم تحديده، فلن يتم استدعاء أي دالة رد نداء.
يوقف هذا التابع عملية مراقبة التغييرات في موقع الجهاز، والمشار إليها من قبل المعامل watchID
.
navigator.geolocation.clearWatch(watchID);
المعامل المُمرَّر إلى التابع هو:
watchID
: سلسلة نصية تُمثِّل مُعرِّف المجالwatchPosition
المُراد حذفه.
إليك المثال التالي:
// خيارات: مراقبة التغيرات في الموقع الجغرافي، مع الموقع
// استخدام أدق وسائل تحديد الموقع المُمكنة
//
var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
// ...في وقت لاحق...
navigator.geolocation.clearWatch(watchID);
كائنات (للقراءة فقط)
Position
يحتوي الكائن Position
على إحداثيات الموقع الجغرافي مع بصمة زمنية (timestamp)؛ يتم انشاؤه من قبل الواجهة البرمجية للإضافة.
خاصيات هذا الكائن هي:
coords
: مجموعة من الإحداثيات الجغرافية.timestamp
: البصمة الزمنية التي تحدد وقت تسجيل الإحداثياتcoords
.
Coordinates
يُربَطُ الكائنُ Coordinates
بكائنٍ Position
، والذي يتم توفيره لدوال رد النداء (callback functions) الخاصة بطلبيات (requests) الموقع الحالي. يحتوي هذا الكائن على مجموعة من الخاصيات التي تحدد الإحداثيات الجغرافية لموقعٍ ما.
خاصيات هذا الكائن هي:
latitude
: عدد يحدد خط العرض بالدرجات العشرية.longitude
: عدد يحدد خط الطول بالدرجات العشرية.altitude
: عدد يمثِّل ارتفاع الموقع بالأمتار فوق الإهليليج (ellipsoid).accuracy
: عدد يمثِّل مستوى الدقة لإحداثيات الطول والعرض بالأمتار.altitudeAccuracy
: عدد يحدد مستوى دقة إحداثيات الإرتفاع بالأمتار.heading
: عدد يمثِّل اتجاه السفر، يُحدّد بعدد الدرجات في اتجاه عقارب الساعة نسبةً إلى الشمال الحقيقي.speed
: عدد يحدِّد السرعة الأرضية الحالية للجهاز، تُحدد بعدد الأمتار المقطوعة في الثانية.
ملاحظات خاصة بمنصة أندرويد
الخاصية altitudeAccuracy
غير مدعومة في أجهزة أندرويد، لذا ستحوي القيمة null
.
PositionError
يُمرّر الكائن PositionError
إلى دالة رد النداء geolocationError
عند حدوث خطأ في الكائن navigator.geolocation
.
خاصيات هذا الكائن هي:
code
: أحد رموز الخطأ المحددة مسبقًا، والمدرجة أدناه.message
: رسالة خطأ تحتوي تفاصيل الخطأ الذي وقع.
ثوابت هذا الكائن هي:
PositionError.PERMISSION_DENIED
: يعاد هذا الثابت عندما يرفض المستخدمون السماح للتطبيق بالوصول إلى معلومات الموقع الجغرافي. يتعلق هذا الثابت بالمنصة المُستخدمة.PositionError.POSITION_UNAVAILABLE
: يعاد عندما يعجز الجهاز عن الحصول على الموقع الجغرافي. بشكل عام، هذا يعني أنّ الجهاز ليس متصلًا بأي بشبكة، أو لا يمكنه الوصول إلى القمر الصناعي.PositionError.TIMEOUT
: يعاد عندما يتعذر على الجهاز الحصول على الموقع الجغرافي خلال الوقت المحدد بواسطة المعاملtimeout
المتضمَّن في الخياراتgeolocationOptions
. عند استخدامها مع التابعnavigator.geolocation.watchPosition
، يمكن تمرير هذا الخطأ مرارًا وتكرارًا إلى دالة رد النداءgeolocationError
كلtimeout
ميلي ثانية.
أمثلة عملية
يمكن استخدام هذه الإضافة لمساعدة المستخدمين على العثور على المواقع أو الأحداث القريبة منهم، مثل عروض Groupon، والمنازل المعروضة للبيع، والأفلام المعروضة حاليًا، والأحداث الرياضية والترفيهية وغير ذلك.
تحتوي هذه الفقرة على مجموعة من الأفكار التي توضح كيفية استغلال هذه الإضافة. في الشيفرات البرمجية أدناه، ستتعلم بعض الطرق السهلة لإضافة الميزات التالية إلى تطبيقك.
- الحصول على إحداثيات موقعك
- الحصول على توقعات الطقس
- تلقي تحديثات توقعات الطقس أثناء القيادة
- التعرف على موقعك على الخريطة
- البحث عن متجر قريب
- مطالعة صور عن المنطقة المحيطة بك
الحصول على إحداثيات موقعك الجغرافي
function getWeatherLocation() {
navigator.geolocation.getCurrentPosition
(onWeatherSuccess, onWeatherError, { enableHighAccuracy: true });
}
الحصول على توقعات الطقس
// دالة النجاح التي ستُمرر إليها الإحداثيات الجغرافية
var onWeatherSuccess = function (position) {
Latitude = position.coords.latitude;
Longitude = position.coords.longitude;
getWeather(Latitude, Longitude);
}
// الحصول على معلومات الطقس انطلاقا من معلومات الموقع الجغرافي
function getWeather(latitude, longitude) {
// http://openweathermap.org/ الحصول على مفتاح من الموقع
// بالمفتاح الذي حصلت عليه "Your_Key_Here" استبدل السلسلة النصية
var OpenWeatherAppKey = "Your_Key_Here";
var queryString =
'http://api.openweathermap.org/data/2.5/weather?lat='
+ latitude + '&lon=' + longitude + '&appid=' + OpenWeatherAppKey + '&units=imperial';
$.getJSON(queryString, function (results) {
if (results.weather.length) {
$.getJSON(queryString, function (results) {
if (results.weather.length) {
$('#description').text(results.name);
$('#temp').text(results.main.temp);
$('#wind').text(results.wind.speed);
$('#humidity').text(results.main.humidity);
$('#visibility').text(results.weather[0].main);
var sunriseDate = new Date(results.sys.sunrise);
$('#sunrise').text(sunriseDate.toLocaleTimeString());
var sunsetDate = new Date(results.sys.sunrise);
$('#sunset').text(sunsetDate.toLocaleTimeString());
}
});
}
}).fail(function () {
console.log("error getting location");
});
}
// دالة رد النداء للخطأ
function onWeatherError(error) {
console.log('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
تلقي تحديثات توقعات الطقس أثناء القيادة
// مراقبة التغيرات في الموقع
function watchWeatherPosition() {
return navigator.geolocation.watchPosition
(onWeatherWatchSuccess, onWeatherError, { enableHighAccuracy: true });
}
// دالة رد النداء للنجاح الخاصة بمراقبة تغيرات موقعك
var onWeatherWatchSuccess = function (position) {
var updatedLatitude = position.coords.latitude;
var updatedLongitude = position.coords.longitude;
if (updatedLatitude != Latitude && updatedLongitude != Longitude) {
Latitude = updatedLatitude;
Longitude = updatedLongitude;
// استدعاء الدوال التي عرّفناها سابقًا
getWeather(updatedLatitude, updatedLongitude);
}
}
التعرف على موقعك على الخريطة
يُوفر كلٌ من الموقعين Bing و Google خدمات الخرائط. سنستخدم في هذا المثال Google.
ستحتاج إلى مفتاحِ لاستخدام خرائط Google، والذي يمكنك الحصول عليه مجانًا إن كنت تريد تجربة الخدمة.
قم بإضافة مرجع إلى الخدمة maps
.
<script src="https://maps.googleapis.com/maps/api/js?key=Your_API_Key"></script>
ثم أضف الشيفرة التالية لاستخدام الخدمة.
var Latitude = undefined;
var Longitude = undefined;
// الحصول على الإحداثيات الجغرافية
function getMapLocation() {
navigator.geolocation.getCurrentPosition
(onMapSuccess, onMapError, { enableHighAccuracy: true });
}
// دالة النجاح التي تستجيب لإحداثيات الموقع الجغرافي
var onMapSuccess = function (position) {
Latitude = position.coords.latitude;
Longitude = position.coords.longitude;
getMap(Latitude, Longitude);
}
// الحصول على الخريطة انطلاقًا من الموقع الجغرافي
function getMap(latitude, longitude) {
var mapOptions = {
center: new google.maps.LatLng(0, 0),
zoom: 1,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
map = new google.maps.Map
(document.getElementById("map"), mapOptions);
var latLong = new google.maps.LatLng(latitude, longitude);
var marker = new google.maps.Marker({
position: latLong
});
marker.setMap(map);
map.setZoom(15);
map.setCenter(marker.getPosition());
}
// دالة النجاح التي تستجيب للتغيرات في الموقع الجغرافي
var onMapWatchSuccess = function (position) {
var updatedLatitude = position.coords.latitude;
var updatedLongitude = position.coords.longitude;
if (updatedLatitude != Latitude && updatedLongitude != Longitude) {
Latitude = updatedLatitude;
Longitude = updatedLongitude;
getMap(updatedLatitude, updatedLongitude);
}
}
// دالة الاستجابة للخطأ
function onMapError(error) {
console.log('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// مراقبة التغيرات في موقعك الجغرافي
function watchMapPosition() {
return navigator.geolocation.watchPosition
(onMapWatchSuccess, onMapError, { enableHighAccuracy: true });
}
البحث عن متجر قريب
يمكنك استخدام نفس مفتاح جوجل في هذا المثال.
أضف مرجعًا إلى الخدمة places
.
<script src=
"https://maps.googleapis.com/maps/api/js?key=Your_API_Key&libraries=places">
</script>
ثم أضف الشيفرة التالية لاستخدام هذه الخدمة.
var Map;
var Infowindow;
var Latitude = undefined;
var Longitude = undefined;
// الحصول على الإحداثيات الجغرافية
function getPlacesLocation() {
navigator.geolocation.getCurrentPosition
(onPlacesSuccess, onPlacesError, { enableHighAccuracy: true });
}
// دالة النجاح للاستجابة لإحداثيات الموقع الجغرافي
var onPlacesSuccess = function (position) {
Latitude = position.coords.latitude;
Longitude = position.coords.longitude;
getPlaces(Latitude, Longitude);
}
// التعرف على الأمكنة انطلاقا من احداثيات الموقع الجغرافي
function getPlaces(latitude, longitude) {
var latLong = new google.maps.LatLng(latitude, longitude);
var mapOptions = {
center: new google.maps.LatLng(latitude, longitude),
zoom: 15,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
Map = new google.maps.Map(document.getElementById("places"), mapOptions);
Infowindow = new google.maps.InfoWindow();
var service = new google.maps.places.PlacesService(Map);
service.nearbySearch({
location: latLong,
radius: 500,
type: ['store']
}, foundStoresCallback);
}
// دالة النجاح للاستجابة للتغيرات في الموقع الجغرافي
var onPlacesWatchSuccess = function (position) {
var updatedLatitude = position.coords.latitude;
var updatedLongitude = position.coords.longitude;
if (updatedLatitude != Latitude && updatedLongitude != Longitude) {
Latitude = updatedLatitude;
Longitude = updatedLongitude;
getPlaces(updatedLatitude, updatedLongitude);
}
}
// دالة النجاح للاستجابة للعثور على متجر قريب
function foundStoresCallback(results, status) {
if (status === google.maps.places.PlacesServiceStatus.OK) {
for (var i = 0; i < results.length; i++) {
createMarker(results[i]);
}
}
}
// على كل متجر عثرت عليه في الخريطة pin وضع علامة
function createMarker(place) {
var placeLoc = place.geometry.location;
var marker = new google.maps.Marker({
map: Map,
position: place.geometry.location
});
google.maps.event.addListener(marker, 'click', function () {
Infowindow.setContent(place.name);
Infowindow.open(Map, this);
});
}
// دالة الخطأ
function onPlacesError(error) {
console.log('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// مراقبة التغير في موقعك الجغرافي
function watchPlacesPosition() {
return navigator.geolocation.watchPosition
(onPlacesWatchSuccess, onPlacesError, { enableHighAccuracy: true });
}
مطالعة صور عن المنطقة المحيطة بك
يمكن أن تُرفق الصور الرقمية مع الإحداثيات الجغرافية للمكان الذي التُقطت فيه.
استخدم الواجهة البرمجية لموقع Flickr للعثور على الصور التي التُقِطت بالقرب من مكان تواجدك. ومثل خدمات جوجل، ستحتاج إلى مفتاح، ولكنه مجاني إن كنت ترغب في التجربة فحسب.
var Latitude = undefined;
var Longitude = undefined;
// الحصول على الاحداثيات الجغرافية
function getPicturesLocation() {
navigator.geolocation.getCurrentPosition
(onPicturesSuccess, onPicturesError, { enableHighAccuracy: true });
}
// دالة النجاح للاستجابة لاحداثيات الموقع الجغرافي
var onPicturesSuccess = function (position) {
Latitude = position.coords.latitude;
Longitude = position.coords.longitude;
getPictures(Latitude, Longitude);
}
// الحصول على الصور باستخدام احداثيات الموقع الجغرافي
function getPictures(latitude, longitude) {
$('#pictures').empty();
var queryString =
"https://api.flickr.com/services/rest/?method=flickr.photos.search&api_key=Your_API_Key&lat="
+ latitude + "&lon=" + longitude + "&format=json&jsoncallback=?";
$.getJSON(queryString, function (results) {
$.each(results.photos.photo, function (index, item) {
var photoURL = "http://farm" + item.farm + ".static.flickr.com/" +
item.server + "/" + item.id + "_" + item.secret + "_m.jpg";
$('#pictures').append($("<img />").attr("src", photoURL));
});
}
);
}
// دالة النجاح للاستجابة للتغيرات في موقعك الجغرافي
var onPicturesWatchSuccess = function (position) {
var updatedLatitude = position.coords.latitude;
var updatedLongitude = position.coords.longitude;
if (updatedLatitude != Latitude && updatedLongitude != Longitude) {
Latitude = updatedLatitude;
Longitude = updatedLongitude;
getPictures(updatedLatitude, updatedLongitude);
}
}
// دالة الخطأ
function onPicturesError(error) {
console.log('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// مراقبة التغيرات في موقعك الجغرافي
function watchPicturePosition() {
return navigator.geolocation.watchPosition
(onPicturesWatchSuccess, onPicturesError, { enableHighAccuracy: true });
}
انظر أيضًا
- إضافة الكاميرا
- إضافة مربعات الحوار
- إضافة حالة الشبكة