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