هذا المنتج أو هذه الميزة في حالة "قديم". لمزيد من المعلومات عن الحالة "قديمة"، يُرجى الاطّلاع على المنتجات والميزات القديمة. لنقل البيانات إلى Places API لنظام التشغيل iOS(الإصدار الجديد)، يُرجى الاطّلاع على دليل نقل البيانات.
نظرة عامة على حزمة تطوير برامج Places SDK (القديمة)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك حزمة تطوير البرامج (SDK) الخاصة بـ "أماكن Google" البحث عن معلومات حول مجموعة متنوعة من أنواع الأماكن واستردادها باستخدام سلسلة نصية أو حسب القرب. Places SDK هي الإصدار القديم من Places SDK (الإصدار الجديد).
استخدِم هذا الدليل للتعرّف على الاختلافات الرئيسية بين إصدارات Places SDK
والانتقال إلى Places SDK (الإصدار الجديد).
ميزات حزمة تطوير البرامج (SDK) المتوفّرة في كل إصدار
يوضّح الجدول التالي إصدارات حزمة تطوير البرامج (SDK) وواجهة برمجة التطبيقات المطلوبة لكل ميزة من ميزات حزمة تطوير البرامج (SDK):
يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير البرامج Places SDK لنظام التشغيل iOS (جديد).
تم تنفيذه على منصة Google Cloud العادية
يتم تنفيذ حزمة تطوير برامج Places SDK لنظام التشغيل iOS (الجديدة) على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية.
يوفّر هذا التصميم الموحّد مستوى من الاتساق في جميع حِزم SDK، ما يحسّن كفاءة عملية التطوير باستخدام حزمة تطوير البرامج Places SDK لنظام التشغيل iOS (الجديدة).
تحسين الأداء
توفّر حزمة تطوير البرامج (SDK) الجديدة الخاصة بـ "أماكن Google" لنظام التشغيل iOS أداءً محسّنًا، ما يجعل من المفيد استبدال التطبيقات التي تستخدم حزمة تطوير البرامج الحالية.
الميزات الجديدة
تتضمّن حزمة تطوير برامج الأماكن لأجهزة iOS (الجديدة) أحدث إصدارات جميع ميزات حزمة تطوير البرامج:
تم تبسيط الأسعار في "حزمة تطوير البرامج للأماكن" لنظام التشغيل iOS (الإصدار الجديد) حتى لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ الأسعار المبسّطة باستخدام قوائم الحقول، والمعروفة أيضًا باسم أقنعة الحقول.
باستخدام Places SDK for iOS وText Search، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الردّ. بعد ذلك، سيتم تحصيل الرسوم منك مقابل البيانات المطلوبة فقط. يُعدّ استخدام قائمة الحقول من ممارسات التصميم الجيدة لأنّها تتيح لك تجنُّب طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
للحصول على معلومات تفصيلية عن أسعار حزمتَي SDK، يُرجى الاطّلاع على الاستخدام والفوترة.
أنواع الأماكن الموسّعة
تتضمّن حزمة SDK الجديدة أنواعًا جديدة من الأماكن يتم عرضها كجزء من استجابة Place Details وText Search. يمكنك أيضًا استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام ميزة "البحث النصي". يتم تضمين الأنواع الجديدة في الجدول
أ.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["The Places SDK lets you search for and retrieve information for a variety of\nplace types using a text string or by proximity. Places SDK is the legacy\nversion of Places SDK (New).\n\nUse this guide to understand the key differences between the Places SDK versions\nand migrate to Places SDK (New).\n\nSDK features available in each version\n\nThe following table shows which SDK and API versions are required for each SDK\nfeature:\n\n| Places SDK for iOS (New) | Minimum SDK Version | Places SDK for iOS | Minimum SDK Version |\n|-----------------------------------------------------------------------------|---------------------|-------------------------------------------------------------------|---------------------|\n| [Place Details (New)](/maps/documentation/places/ios-sdk/details-place) | 9.0.0 | [Place Details](/maps/documentation/places/ios-sdk/place-details) | 3.0.0 |\n| [Place Photo (New)](/maps/documentation/places/ios-sdk/place-photos) | 9.0.0 | [Place Photo](/maps/documentation/places/ios-sdk/photos) | 3.0.0 |\n| [Text Search (New)](/maps/documentation/places/ios-sdk/text-search) | 8.5.0 | | |\n| [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search) | 9.0.0 | | |\n| [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete) | 9.0.0 | [Autocomplete](/maps/documentation/places/ios-sdk/autocomplete) | 3.0.0 |\n| | | [Current Place](/maps/documentation/places/ios-sdk/current-place) | 3.0.0 |\n\nMigrate to the new APIs\n\nTo migrate to the new APIs, see the following migration guides:\n\n- [Migrate to Place Details (New)](/maps/documentation/places/ios-sdk/migrate-details)\n- [Migrate to Place Photo (New)](/maps/documentation/places/ios-sdk/migrate-photo)\n- [Migrate to Autocomplete (New)](/maps/documentation/places/ios-sdk/migrate-autocomplete)\n\nEnhancements in Places SDK for iOS (New)\n\nThis section covers key features added to Places SDK for iOS\n(New).\n\nImplemented on the Google Cloud standard platform\n\nPlaces SDK for iOS (New) is implemented on the [service\ninfrastructure](https://cloud.google.com/service-infrastructure/docs/overview)\non Google Cloud. This implementation brings a more secure and trusted platform.\nThis standard design brings a level of consistency across the SDKs that improve\nthe efficiency of development with Places SDK for iOS\n(New).\n\nImproved performance\n\nPlaces SDK for iOS (New) provides improved performance, making\nit worthwhile to replace apps that use the existing SDK.\n\nNew features\n\nThe Places SDK for iOS (New) includes the latest versions of\nall of the SDK features:\n\n- [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete)\n- [Place Details (New)](/maps/documentation/places/ios-sdk/details-place)\n- [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search)\n- [Place Photos (New)](/maps/documentation/places/ios-sdk/place-photos)\n- [Text Search (New)](/maps/documentation/places/ios-sdk/text-search)\n\nSimplified pricing\n\nPricing is simplified with Places SDK for iOS (New) so that\nyou only pay for the data you use. Simplified pricing is implemented using field\nlists, also called *field masks*.\n\nWith Places SDK for iOS and\nText Search you use field lists to control the list of\nfields to return in the response. You are then only billed for the data\nrequested. Using a field list is a good design practice so that you don't\nrequest unnecessary data, which helps to avoid unnecessary processing time and\nbilling charges.\n\nFor detailed pricing information for both SDKs, see [Usage and\nBilling](/maps/documentation/places/ios-sdk/usage-and-billing).\n\nExpanded place types\n\nThe new SDK includes new place types, which are returned as part of the\nPlace Details and Text Search\nresponse. You can also use these new types, and the existing types, in a search\nwith Text Search. The new types are included in [Table\nA](/maps/documentation/places/ios-sdk/place-types#table-a)."]]
