نظرة عامة

مقدمة

تسمح لك حزمة تطوير برامج الأماكن لأجهزة Android بإنشاء تطبيقات تتبع المواقع الجغرافية تستجيب استنادًا إلى السياق مع الأنشطة التجارية المحلية والأماكن الأخرى القريبة من جهاز المستخدم. هذا يعني أنك إنشاء تطبيقات مفيدة استنادًا إلى الأماكن التي تعني شيئًا ما للمستخدم، وذلك لاستكمال الخدمات البسيطة المستندة إلى الموقع الجغرافي والتي يقدمها خدمات الموقع الجغرافي في Android:

المفاهيم

توفر الواجهات التالية نقاط الدخول الرئيسية إلى حزمة تطوير برامج الأماكن لأجهزة Android:

• Places يتيح الوصول الآلي إلى قاعدة بيانات Google للأماكن والأنشطة التجارية المحلية بالإضافة إلى المكان الحالي للجهاز.
• Autocomplete توفر تطبيقات مصغّرة معدة مسبقًا لعرض التنبؤات استجابةً لطلب المستخدم استعلامات البحث.

يُعرَّف المكان بأنّه مساحة مادية تحمل اسمًا. طريقة أخرى التفكير في مكان ما هو أنه أي شيء يمكنك العثور عليه على الخريطة. تتضمن الأمثلة الأنشطة التجارية المحلية ونقاط الاهتمام والمواقع الجغرافية المواقع. في واجهة برمجة التطبيقات، يتم تمثيل المكان بواسطة Place من واجهة pyplot. وهي تتضمن معلومات مثل اسم المكان عنوان، موقع جغرافي، معرّف مكان، رقم الهاتف، نوع المكان، موقع إلكتروني وغير ذلك.

اختيار إصدار حزمة SDK

يتم تحديد حزمة تطوير برامج الأماكن لميزات Android المتاحة في تطبيقك من خلال مجموعة من رقم إصدار حزمة تطوير البرامج (SDK) (مثل 3.5.0) الذي تحدّده في إعدادات تطبيقك، واجهات برمجة التطبيقات المفعّلة على مفتاح واجهة برمجة التطبيقات وكيف يمكنك إعداد تطبيقك. لمزيد من المعلومات حول أوجه الاختلاف بين حزمة تطوير برامج الأماكن لأجهزة Android وحزمة تطوير البرامج للأماكن لنظام التشغيل Android (جديدة)، راجع اختَر إصدار حزمة SDK.

مهمتك الأولى هي تحديد حزمة SDK التي تريد استخدامها. هذا صحيح إذا كنت عميلاً جديدًا أو لعميل حالي يستخدم حزمة SDK بالفعل. للتعرّف على الاختلافات الرئيسية بين إصدارَي حزمة SDK، اتّبِع الخطوات التالية: يُرجى الاطّلاع على مقالة اختيار إصدار حزمة SDK.

الأسعار لكل إصدار من إصدارات حزمة تطوير البرامج (SDK)

إنّ إصدار حزمة تطوير البرامج (SDK) الذي تفعّله يتحكّم في أسعار استخدامك لحزمة SDK. توفر حزمة تطوير برامج الأماكن لنظام التشغيل Android (الجديدة) نموذج أسعار مبسطًا بحيث تدفع فقط مقابل البيانات التي تستخدمها. للحصول على معلومات تفصيلية عن الأسعار لكليهما حزمة تطوير برامج الأماكن لأجهزة Android وحزمة SDK للأماكن لنظام التشغيل Android (جديدة)، اطلع على الاستخدام والفوترة:

نظرة عامة على واجهة برمجة التطبيقات

ساعد عملاءك على استكشاف مكان وجودهم وما يحيط بهم:

• الإكمال التلقائي للأماكن تملأ تلقائيًا اسم و/أو عنوان مكان أثناء كتابة المستخدمين.
• يعرض الحقل المكان الحالي قائمة بالأماكن التي يُعرف فيها آخر مرة تم فيها تحديد موقع جهاز المستخدم، بالإضافة إلى إشارة إلى الاحتمال النسبي لكل مكان.
• إرجاع Place Details (تفاصيل المكان) لعرض معلومات أكثر تفصيلاً حول المكان.
• يعرض البحث النصي الأماكن استنادًا إلى في سلسلة نص بحث. يعد البحث النصي جزءًا من حزمة تطوير برامج الأماكن لأجهزة Android (جديد).
• تعرض ميزة صور الأماكن جودة عالية صور لمكان معين.
• تخزِّن أرقام تعريف الأماكن المعرّف الفريد. عن مكان واحد أو أكثر لاسترداد معلومات المكان عند الطلب.

السياسات والأحكام

يجب أن تتقيّد جميع التطبيقات التي تستخدم حزمة تطوير برامج الأماكن لنظام التشغيل Android بهذا الخصوص. بالمتطلبات الموضحة في بنود خدمة "منصة خرائط Google" الاستخدام والفوترة عرض عمليات تحديد المصدر: