مقدمة
تتيح لك حزمة تطوير برامج الأماكن لأجهزة iOS إنشاء تطبيقات مستنِدة إلى الموقع الجغرافي تستجيب في سياق الأنشطة التجارية المحلية والأماكن الأخرى بالقرب من الجهاز. وهذا يعني أنه يمكنك إنشاء تطبيقات غنية استنادًا إلى الأماكن التي تعني شيئًا للمستخدم.
المفاهيم
يتم تعريف المكان على أنّه مساحة مادية تحمل اسمًا. هناك طريقة أخرى للتفكير في المكان وهي أنه أي شيء يمكنك العثور عليه على الخريطة.
تتضمن الأمثلة الأنشطة التجارية المحلية ونقاط الاهتمام والمواقع الجغرافية. في واجهة برمجة التطبيقات، يتم تمثيل المكان من خلال
GMSPlace Class Reference.
وهي تشمل معلومات مثل اسم المكان وعنوانه والموقع الجغرافي ورقم تعريف المكان ورقم الهاتف ونوع المكان وعنوان URL للموقع الإلكتروني وغير ذلك.
اختيار إصدار حزمة تطوير البرامج (SDK)
تتوافق حزمة تطوير برامج الأماكن لنظام التشغيل iOS مع إصدارين من حزمة تطوير البرامج: إما حزمة SDK الحالية للأماكن لنظام التشغيل iOS وحزمة SDK للأماكن لنظام التشغيل iOS (جديد)، الجيل التالي من حزمة SDK.
مهمتك الأولى هي تحديد حزمة تطوير البرامج (SDK) التي ستستخدمها. هذا صحيح إذا كنت عميلاً جديدًا أو عميلاً حاليًا يستخدم حزمة SDK. لمعرفة الاختلافات الرئيسية بين إصدارَي حزمة SDK، يمكنك الاطّلاع على اختيار إصدار حزمة SDK.
السعر لكلّ إصدار من إصدارات حزمة SDK
إنّ الإصدار الذي اخترته من حزمة SDK يتحكم في الأسعار. تتوافق حزمة تطوير برامج الأماكن لنظام التشغيل iOS (الجديدة) مع نموذج أسعار مبسط بحيث تدفع مقابل البيانات التي تستخدمها فقط. للحصول على معلومات مفصّلة حول الأسعار لكل من حزمتَي تطوير البرامج (SDK)، يُرجى الاطّلاع على الاستخدام والفوترة.
معاينة إصدار GooglePlacesSwift
يحتوي هذا الإصدار على إصدار المعاينة من الإصدار 0.1.0 من GooglePlacesSwift. تتيح لك GooglePlacesSwift استخدام واجهة Swift جديدة لطلب بيانات بواجهات برمجة تطبيقات المكان، بما في ذلك جميع واجهات برمجة التطبيقات في حزمة تطوير البرامج للأماكن المخصّصة لنظام التشغيل iOS (جديدة):
- الإكمال التلقائي للأماكن (جديد)
- تفاصيل المكان (جديدة)
- صور المكان (جديدة)
- البحث النصي (جديد)
- بحث قريب (جديد)
تتطلب GooglePlacesSwift ما يلي:
- عليك تمكين واجهة برمجة تطبيقات الأماكن (جديدة) على مفتاح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.
- Xcode 15.3.
لمزيد من المعلومات، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات GooglePlacesSwift.
نظرة عامة على حزمة تطوير البرامج (SDK)
استخدم حزمة تطوير برامج الأماكن لأجهزة iOS لمساعدة عملائك في استكشاف أماكن وجودهم وما حولهم. توفر حزمة Places SDK لنظام التشغيل iOS واجهات برمجة التطبيقات التالية:
| حزمة تطوير برامج الأماكن لأجهزة iOS (جديدة) | حزمة تطوير برامج الأماكن لأجهزة iOS | الوصف |
|---|---|---|
| تفاصيل المكان (جديد) | تفاصيل المكان | عرض معلومات حول الأماكن، بما في ذلك اسم المكان وعنوانه والموقع الجغرافي ونوع المكان (مثل ملهى ليلي أو متجر حيوانات أليفة أو متحف) وغير ذلك |
| صورة المكان (جديدة) | صورة المكان | تعرض صورًا عالية الجودة لأحد الأماكن. |
| البحث النصي (جديد) | عرض معلومات حول مجموعة من الأماكن بناءً على بحث نصي. | |
| البحث عن الأجهزة القريبة (جديد) | تعرض معلومات عن مجموعة من الأماكن من خلال تحديد الموقع الجغرافي كمنطقة بحث. | |
| الإكمال التلقائي (جديد) | الإكمال التلقائي | يملأ هذا الحقل تلقائيًا اسم و/أو عنوان المكان أثناء كتابة المستخدمين. |
| المكان الحالي | عرض قائمة بالأماكن التي يعرف آخر موقع جغرافي فيها المستخدم على الجهاز، بالإضافة إلى إشارة إلى الاحتمالية النسبية لكل مكان |
تشمل الميزات البارزة الأخرى لحِزم SDK ما يلي:
- يتم رصد الأماكن بدقة عند انخفاض طاقة البطارية من خلال البحث عن شبكات Wi-Fi.
- التخزين المؤقت على الجهاز: قد تتضمن معظم الطلبات المُرسَلة إلى حزمة "SDK للأماكن" لنظام التشغيل iOS رحلة ذهاب وعودة إلى خادم Google، ولكن يمكنك أيضًا تخزين البيانات مؤقتًا محليًا لمدة 30 يومًا.
السياسات والأحكام
يجب أن تتقيّد جميع التطبيقات التي تستخدم حزمة تطوير برامج الأماكن لأجهزة iOS بالمتطلبات الموضّحة في بنود خدمة منصة "خرائط Google" وعرض عمليات تحديد المصدر.