نظرة عامة

مقدمة

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

المفاهيم

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

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

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

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

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

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

أسعار كل إصدار من حزمة SDK

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

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

يمكنك مساعدة عملائك في استكشاف المكان الذي يقيمون فيه والأماكن المحيطة بهم:

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

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

يجب أن تلتزم جميع التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على Android بالمتطلبات الموضّحة في بنود خدمة "منصّة خرائط Google"، الاستخدام والفوترة، عرض الإسناد.