نظرة عامة على حزمة تطوير برامج Places SDK (القديمة)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك حزمة تطوير البرامج (SDK) الخاصة بـ "أماكن Google" البحث عن معلومات حول مجموعة متنوعة من أنواع الأماكن واستردادها باستخدام سلسلة نصية أو حسب القرب. Places SDK هي الإصدار القديم من Places SDK (الإصدار الجديد).
استخدِم هذا الدليل للتعرّف على الاختلافات الرئيسية بين إصدارات Places SDK
والانتقال إلى Places SDK (الإصدار الجديد).
ميزات حزمة تطوير البرامج (SDK) المتوفّرة في كل إصدار
يوضّح الجدول التالي إصدارات حزمة تطوير البرامج (SDK) وواجهة برمجة التطبيقات المطلوبة لكل ميزة من ميزات حزمة تطوير البرامج (SDK):
يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى "حزمة تطوير البرامج للأماكن" لنظام التشغيل Android (الإصدار الجديد).
تم تنفيذه على منصة Google Cloud العادية
يتم تنفيذ "حزمة تطوير البرامج للأماكن في Android" (الإصدار الجديد) على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية.
يوفّر هذا التصميم الموحّد مستوى من الاتساق في جميع حِزم SDK، ما يحسّن كفاءة عملية التطوير باستخدام "حزمة تطوير البرامج (SDK) للأماكن في Android" (الإصدار الجديد).
تحسين الأداء
توفّر حزمة Places SDK لنظام التشغيل Android (الجديدة) أداءً محسّنًا، ما يجعلها بديلاً مناسبًا للتطبيقات التي تستخدم حزمة SDK الحالية.
الميزات الجديدة
تتضمّن حزمة Places SDK for Android (إصدار جديد) أحدث إصدارات جميع ميزات حزمة SDK:
تعرض خدمة البحث النصي (جديدة) معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في نيويورك" أو "متاجر أحذية بالقرب من أوتاوا" أو "123 شارع مين". تستجيب الخدمة بقائمة
بالأماكن التي تطابق السلسلة النصية وأي تحيّز للموقع الجغرافي تم ضبطه.
تمت إضافة بيانات استجابة جديدة إلى "تفاصيل الأماكن" (جديد) و"صور الأماكن" (جديد)
يتضمّن تفاصيل المكان
(الجديد) الآن فئة
المراجعة
الجديدة في عنصر الاستجابة Place. يحتوي فئة
Place على طريقة getReviews() الجديدة التي تتيح استخدام هذا الحقل. استخدِم طريقة getReviews() Call لعرض ما يصل إلى خمس مراجعات لمكان معيّن.
تمت إضافة استجابة URI جديدة إلى Place Photos (New)
يمكنك الآن استخدام
Place Photo
(جديد) لعرض معرّف URI لخريطة بتات لصورة. في السابق، كان بإمكانك عرض الصورة النقطية فقط.
الأسعار المبسّطة
تم تبسيط الأسعار في "حزمة تطوير البرامج للأماكن" (الإصدار الجديد) لنظام التشغيل Android، وبالتالي لن تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ ميزة "الأسعار المخفَّضة" باستخدام قوائم الحقول، والمعروفة أيضًا باسم أقنعة الحقول.
باستخدام خدمة "تفاصيل المكان" وخدمة "البحث النصي"، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الردّ. بعد ذلك، سيتم تحصيل الرسوم منك مقابل البيانات المطلوبة فقط. يُعدّ استخدام قائمة الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
للحصول على معلومات تفصيلية عن أسعار حزمتَي SDK، يُرجى الاطّلاع على الاستخدام والفوترة.
أنواع الأماكن الموسّعة
تتضمّن حزمة SDK الجديدة أنواعًا جديدة من الأماكن يتم عرضها كجزء من استجابة Place Details وText Search. يمكنك أيضًا استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام ميزة "البحث النصي". يتم تضمين الأنواع الجديدة في الجدول
أ.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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| Feature | Places API enabled on API key | Initialization method | Minimum SDK version |\n|---------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|\n| [Autocomplete (New)](/maps/documentation/places/android-sdk/place-autocomplete) | Places API (New) | [`initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String)) | 3.5.0 |\n| [Place Details (New)](/maps/documentation/places/android-sdk/details-place) | Places API (New) | [`initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String)) | 3.3.0 |\n| [Nearby Search (New)](/maps/documentation/places/android-sdk/nearby-search) | Places API (New) | [`initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String)) | 3.5.0 |\n| [Place Photos (New)](/maps/documentation/places/android-sdk/place-photos) | Places API (New) | [`initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String)) | 3.4.0 |\n| [Text Search (New)](/maps/documentation/places/android-sdk/text-search) | Places API (New) | [`initializeWithNewPlacesApiEnabled()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initializeWithNewPlacesApiEnabled(android.content.Context,%20java.lang.String)) | 3.3.0 |\n| [Place Autocomplete](/maps/documentation/places/android-sdk/autocomplete) | Places API | [`initialize()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initialize(android.content.Context,%20java.lang.String)) | |\n| [Current Place](/maps/documentation/places/android-sdk/current-place) | Places API | [`initialize()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initialize(android.content.Context,%20java.lang.String)) | |\n| [Place Details](/maps/documentation/places/android-sdk/place-details) | Places API | [`initialize()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initialize(android.content.Context,%20java.lang.String)) | |\n| [Place Photos](/maps/documentation/places/android-sdk/photos) | Places API | [`initialize()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places#initialize(android.content.Context,%20java.lang.String)) | |\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/android-sdk/migrate-details)\n- [Migrate to Place Photo (New)](/maps/documentation/places/android-sdk/migrate-photo)\n- [Migrate to Autocomplete (New)](/maps/documentation/places/android-sdk/migrate-autocomplete)\n\nEnhancements in Places SDK for Android (New)\n\nThis section covers key features added to Places SDK for Android (New).\n\nImplemented on the Google Cloud standard platform\n\nPlaces SDK for Android (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 Android\n(New).\n\nImproved performance\n\nPlaces SDK for Android (New) provides improved performance, making it\nworthwhile to replace apps that use the existing SDK.\n\nNew features\n\nThe Places SDK for Android (New) includes the latest versions of all of the SDK\nfeatures:\n\n- [Autocomplete (New)](/maps/documentation/places/android-sdk/place-autocomplete)\n- [Place Details (New)](/maps/documentation/places/android-sdk/details-place)\n- [Nearby Search (New)](/maps/documentation/places/android-sdk/nearby-search)\n- [Place Photos (New)](/maps/documentation/places/android-sdk/place-photos)\n- [Text Search (New)](/maps/documentation/places/android-sdk/text-search)\n\nNew Text Search service\n\n[Text Search](/maps/documentation/places/android-sdk/legacy/text-search) (New) returns information\nabout a set of places based on a string --- for example \"pizza in New York\" or\n\"shoe stores near Ottawa\" or \"123 Main Street\". The service responds with a list\nof places matching the text string and any location bias that has been set.\n\nNew response data added to Placed Details (New) and Place Photos (New)\n\n- [Place Details](/maps/documentation/places/android-sdk/details-place)\n (New) now includes the new\n [Review](/maps/documentation/places/android-sdk/legacy/reference/com/google/android/libraries/places/api/model/Review)\n class in the response `Place` object. The\n [Place](/maps/documentation/places/android-sdk/legacy/reference/com/google/android/libraries/places/api/model/Place) class\n contains the new `getReviews()` method to support this field. Call\n `getReviews()` to return up to five reviews for a place.\n\n- [Place Photo](/maps/documentation/places/android-sdk/place-photos)\n (New) adds the\n [`AuthorAttributions`](/maps/documentation/places/android-sdk/legacy/reference/com/google/android/libraries/places/api/model/AuthorAttributions)\n to the `PhotoMetadata` class. `AuthorAttributions` contains a `List` of\n [`AuthorAttribution`](/maps/documentation/places/android-sdk/legacy/reference/com/google/android/libraries/places/api/model/AuthorAttribution)\n objects.\n\nNew URI response added to Place Photos (New)\n\nYou can now use\n[Place Photo](/maps/documentation/places/android-sdk/place-photos)\n(New) to return a URI to an image bitmap. Previously, you could only return the\nimage bitmap itself.\n\nSimplified pricing\n\nPricing is simplified with Places SDK for Android (New) so that you only\npay for the data you use. Simplified pricing is implemented using field lists,\nalso called *field masks*.\n\nWith Place Details 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 to ensure 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/android-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/android-sdk/place-types#table-a)."]]
