تحدّد هذه السمة واجهة لتقديم بيانات الموقع الجغرافي، عادةً لكائن GoogleMap.
يحتوي العنصر GoogleMap على موفّر موقع مضمّن لطبقة موقعي، ولكن يمكن أن يكون replaced مع موفّر آخر يطبّق هذه الواجهة.
يفعِّل عنصر GoogleMap موفّر الموقع الجغرافي باستخدام activate(OnLocationChangedListener). عندما يكون مقدّم خدمة الموقع الجغرافي نشطًا (بين activate(OnLocationChangedListener) وdeactivate())، يجب أن يرسل تعديلات الموقع الجغرافي الدورية إلى المستمع المسجَّل في activate(OnLocationChangedListener). تقع على عاتق مقدّم الخدمة مسؤولية استخدام خدمات الموقع الجغرافي بحكمة وفقًا لمراحل نشاط الخريطة. على سبيل المثال، يجب ألا يستخدم الجهاز سوى خدمات تستهلك قدرًا كبيرًا من طاقة البطارية (مثل نظام تحديد المواقع العالمي (GPS)) من حين لآخر أو عندما يكون هناك نشاط في المقدّمة فقط.
ملخص الفئة المدمَجة
| واحدة | LocationSource.OnLocationChangedListener | معالجة تعديل الموقع الجغرافي | |
ملخّص الطريقة العلنية
| فراغ تجريدي | |
| فراغ تجريدي |
deactivate()
يتم إيقاف مقدّم الخدمة هذا.
|
الطرق العامة
يتم إلغاء البيانات الموجزة العامة تفعيل (LocationSource.OnLocationChangedListener مستمع)
تفعيل مقدّم الخدمة هذا سيُرسِل مقدّم الخدمة هذا إشعارًا إلى المستمع المتوفر بشكل دوري إلى أن
تتصل بـ deactivate(). سيتم بث الإشعارات في سلسلة المحادثات الرئيسية.
المَعلمات
| أداة معالجة الحدث | أداة معالجة الحدث التي يتم استدعائها عند توفّر موقع جديد |
|---|
الرميات
| IllegalStateException | إذا كان مقدّم الخدمة هذا نشطًا |
|---|---|
| IllegalArgumentException | إذا كانت قيمة listener هي null
|
فارغ مجرّد إيقاف ()
يتم إيقاف مقدّم الخدمة هذا. ولن يتم إشعار معاودة الاتصال التي تم تسجيلها سابقًا بأي تعديلات أخرى.
الرميات
| IllegalStateException | إذا كان مقدّم الخدمة هذا غير نشط |
|---|