تتيح حزمة تطوير البرامج (SDK) للأماكن على أجهزة iOS لتطبيقات iOS الحصول على معلومات عن الأماكن (الأنشطة التجارية ونقاط الاهتمام والمواقع الجغرافية) من خلال تفاصيل المكان وصور المكان والبحث النصي والبحث في الجوار والإكمال التلقائي. Places API (الإصدار الجديد) هو الإصدار الحالي من حزمة تطوير البرامج (SDK).
حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS: معلومات أساسية
- المنتج: حزمة تطوير برامج الأماكن لأجهزة iOS
- تُعرف أيضًا باسم: حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لتطبيقات iOS (الإصدار الجديد)
- الفئة: الأماكن
- النظام الأساسي: iOS
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج بالاستناد إلى الأماكن لنظام التشغيل iOS
حالات استخدام Places SDK for iOS
استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لتطبيقات iOS في الحالات التالية:
- إذا كنت بحاجة إلى تفاصيل الأماكن أو الصور أو نتائج "البحث النصي" أو "البحث في الجوار" داخل تطبيق iOS أصلي
- تحتاج إلى ميزة الإكمال التلقائي لاسم المكان أو عنوانه أثناء كتابة المستخدمين في تطبيق iOS.
- إذا أردت استخدام مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن المُعدّة مسبقًا (تفاصيل المكان والبحث والإكمال التلقائي) في تطبيق iOS.
لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لتطبيقات iOS في الحالات التالية:
- أنت بصدد إنشاء تطبيق Android أصلي. استخدِم حزمة تطوير البرامج بالاستناد إلى الموقع الجغرافي لنظام التشغيل Android بدلاً من ذلك.
- أنت بصدد إنشاء صفحة ويب في المتصفّح. استخدِم Maps JavaScript API بدلاً من ذلك.
- تحتاج إلى بيانات الأماكن من خادم أو واجهة خلفية عبر بروتوكول HTTP بدلاً من عميل iOS. استخدِم Places API (جديدة) بدلاً من ذلك.
حزمة تطوير برامج الأماكن لأجهزة iOS: الإعداد
- الخدمة المطلوب تفعيلها:
places.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- تحديد مصدر الاستخدام: يمكنك استدعاء طريقة الفئة
addInternalUsageAttributionIDفيGMSPlacesClient(Objective-C/Swift) أوPlacesClient(GooglePlacesSwift) لإضافة معرّف تحديد مصدر الاستخدام، ويؤدي حذف الاستدعاء إلى إيقاف هذه الميزة. - البدء: إعداد حزمة تطوير برامج الأماكن لأجهزة iOS
- المرجع: مرجع حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل iOS
- الأسعار: استخدام حزمة تطوير البرامج (SDK) للأماكن على أجهزة iOS والفوترة
- السياسات: سياسات "حزمة تطوير برامج الأماكن لأجهزة iOS"
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير برامج الأماكن لأجهزة iOS
حِزم SDK الرسمية لـ "الأماكن" على أجهزة iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
حزمة تطوير برامج الأماكن لأجهزة iOS: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
حزمة تطوير برامج الأماكن لأجهزة iOS: الأخطاء الشائعة
- المشكلة: يتعذّر إجراء طلبات Places SDK for iOS (New) إذا لم تكن Places API (New) مفعَّلة في مشروع على السحابة الإلكترونية أو لم تكن مدرَجة في قائمة واجهات برمجة التطبيقات المعتمَدة لمفتاح واجهة برمجة التطبيقات. الحلّ: فعِّل Places API (الجديدة) وأضِفها إلى قيود مفتاح واجهة برمجة التطبيقات التي يستخدمها التطبيق. يُرجى الاطّلاع على /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- المشكلة: يعني الخطأ
kGMSPlacesRateLimitExceeded(-7) أنّ مفتاح واجهة برمجة التطبيقات قد تجاوز الحدّ الأقصى لمعدّل الاستخدام. وتتلقّى التطبيقات التي تستخدم إصدارات حزمة SDK 2.x التي تم إيقافها (في 29 يوليو 2019) هذا الخطأ أيضًا. الحلّ: يُرجى التحقّق من الحصة والاستخدام في Places API (الإصدار الجديد) في Google Cloud Console، وتحديث التطبيقات التي تستخدم إصدارات حزمة تطوير البرامج (SDK) الأقدم من 3.0. يُرجى الاطّلاع على /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - المشكلة: يؤدي استخدام الرموز المميزة للجلسات في تطبيقات متعددة ضمن المشروع نفسه أو في جلسات متعددة إلى تعطيل تجميع الفواتير في جلسات الإكمال التلقائي. الحلّ: أنشِئ رمزًا مميزًا فريدًا للجلسة (يُنصح باستخدام المعرّف الفريد العالمي UUID الإصدار 4) لكل جلسة إكمال تلقائي. يجب أن تكون الرموز المميزة فريدة لكل مشروع. يُرجى الاطّلاع على /maps/documentation/places/ios-sdk/use-session-tokens.
- المشكلة: تعرض التطبيقات بيانات الأماكن بدون معلومات تحديد المصدر التي تعرضها واجهة برمجة التطبيقات. الحلّ: اعرض جميع معلومات تحديد المصدر ذات الصلة التي يتم عرضها مع بيانات "الأماكن"، وفقًا لصفحة السياسات. يُرجى الاطّلاع على /maps/documentation/places/ios-sdk/overview.
حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لنظام التشغيل iOS: الميزات القديمة والمتوقّفة نهائيًا
- حزمة تطوير البرامج بالاستناد إلى الموقع الجغرافي لنظام التشغيل iOS (الإصدار القديم): قديم منذ 2025-03-01. البديل: حزمة Places SDK for iOS (الجديدة) (تتطلّب Places API (الجديدة)). المشكلة: لا تتوفّر الفئات والطرق القديمة (مثل
fetchPlaceFromPlaceIDوGMSAutocompleteFetcherوGMSAutocompleteViewController) في الإصدار 11.0.0 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث، ما يؤدي إلى تعطُّل عملية التجميع. يُرجى الاطّلاع على دليل نقل البيانات. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerوGMSAutocompleteFetcherinitWithBounds:filter: تم إيقافها نهائيًا منذ 13-10-2020. البديل:GMSAutocompleteFilter(locationBiasأوlocationRestriction) فيGMSAutocompleteRequestمعGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:، أو المُعدِّلاتGooglePlacesSwiftplaceAutocompleteأوbasicPlaceAutocompleteلعنصر واجهة مستخدم المؤشر: لا تتوفّر الطرق في الإصدار 4.0.0 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث (وتمت إزالةGMSAutocompleteResultsViewControllerوGMSAutocompleteFetcherفي الإصدار 11.0.0 من حزمة تطوير البرامج (SDK)). يُرجى الاطّلاع على دليل نقل البيانات.- حدود الإكمال التلقائي المستندة إلى
GMSCoordinateBounds(المَعلمتانGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsModeوbounds/boundsModeفيfindAutocompletePredictionsFromQueryوautocompleteQuery): تم إيقافها نهائيًا منذ 2020-10-13. الاستبدال:GMSAutocompleteRequestبـGMSAutocompleteFilter(locationBiasأوlocationRestriction) وGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:، أو المُعدِّلاتGooglePlacesSwiftplaceAutocompleteأوbasicPlaceAutocompleteلعنصر واجهة مستخدم. المشكلة: لا تتوفّر السمات والمَعلمات في الإصدار 4.0.0 من حزمة SDK والإصدارات الأحدث (وتمّت إزالةGMSAutocompleteViewControllerوfindAutocompletePredictionsFromQueryفي الإصدار 11.0.0 من حزمة SDK). يُرجى الاطّلاع على دليل نقل البيانات. GMSPlace.openNowStatus: تم إيقافها نهائيًا منذ 13-10-2020. الاستبدال:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) أوPlacesClient.isPlaceOpen(with:)فيGooglePlacesSwift. المشكلة: السمة غير متوفّرة في الإصدار 4.0.0 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. يُرجى الاطّلاع على دليل نقل البيانات.GMSPlaceFieldكـNS_ENUM: تم إيقافها نهائيًا منذ 2020-10-13. البديل: ثوابتGMSPlacePropertyمع فئات الطلبات، مثلGMSFetchPlaceRequestوGMSPlaceSearchByTextRequestأوPlacePropertyفيGooglePlacesSwift. المؤشر: تم استبدالها بـNS_OPTIONSفي الإصدار 4.0.0 من حزمة تطوير البرامج (SDK) (GMSPlaceFieldلأنّNS_OPTIONSتنتمي إلى واجهة برمجة التطبيقات القديمة وغير متوفّرة في الإصدار 11.0.0 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث). يُرجى الاطّلاع على دليل نقل البيانات.- الإصدار 2.7.0 من حزمة تطوير البرامج (SDK) للأماكن على أجهزة iOS: تم إيقافه نهائيًا منذ 2019-07-29. البديل: الإصدار الحالي من حزمة Places SDK لنظام التشغيل iOS العَرَض: أخطاء في
kGMSPlacesRateLimitExceeded
الإجراءات التي يمكنك تنفيذها باستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لنظام التشغيل iOS
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
حزمة تطوير البرامج (SDK) لأماكن iOS: الذكاء الاصطناعي التوليدي
- تتيح لك هذه الميزة الحصول على ملخّص مستنِد إلى الذكاء الاصطناعي لمراجعات المستخدمين لمعرّف مكان محدّد على Google.
- عرض ملخّص مستنِد إلى الذكاء الاصطناعي عن المنطقة والمرافق المحيطة بمعرّف مكان محدّد على Google لمحطة شحن مركبات كهربائية
حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS: الأماكن
- عرض قائمة بالأماكن وتفاصيل المكان استنادًا إلى سلسلة طلب بحث
- عرض قائمة بالأماكن وتفاصيل المكان بالقرب من موقع جغرافي معيّن
- عرض نتائج الإكمال التلقائي حول الأماكن استنادًا إلى سلسلة طلب بحث
- عرض معلومات تفصيلية عن مكان معيّن
- عرض صور لمكان معيّن ملاحظة: اعرِض مع الصورة معلومات نسبها إلى مؤلفها (اسم المؤلف المرتبط بمعرّف الموارد المنتظم لملفه الشخصي). تتطلّب سياسات Places لكل منصة ذلك، على سبيل المثال /maps/documentation/javascript/policies#photo-attributions و/maps/documentation/places/web-service/policies#photos-and-review.
- تغيير حجم صور الأماكن
- عرض التقييمات والمراجعات لمكان معيّن ملاحظة: في خدمة الويب Places API (الجديدة)، تكون تفاصيل المكان عبارة عن طلب استرداد بيانات باستخدام GET عبر HTTP إلى https://places.googleapis.com/v1/places/{placeId} مع X-Goog-FieldMask (على سبيل المثال، rating,userRatingCount,reviews). ويستخدم البحث النصي والبحث في الجوار والإكمال التلقائي طلبات POST. على أجهزة Android، مرِّر Place.Field.RATING وUSER_RATING_COUNT وREVIEWS إلى PlacesClient.fetchPlace(). على أجهزة iOS، مرِّر GMSPlacePropertyRating وGMSPlacePropertyUserRatingsTotal وGMSPlacePropertyReviews في GMSFetchPlaceRequest.
- يمكنك إضافة تطبيق مصغّر للإكمال التلقائي إلى صفحة ويب أو تطبيق يعرض نتائج عن الأماكن استنادًا إلى سلسلة طلب بحث.
- حدِّد حقول البيانات المضمّنة في ردود معلومات المكان.
- حدِّد أنواع الأماكن التي تريد تضمينها في الردود التي تتضمّن معلومات عن الأماكن.
- عرض معلومات عن المكان الذي يتواجد فيه جهاز المستخدم حاليًا ملاحظة: تمت إزالة طرق Current Place القديمة في الإصدار 6.0 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لخدمة "الأماكن" لنظام التشغيل Android والإصدار 11.0 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لخدمة "الأماكن" لنظام التشغيل iOS. يمكنك استرداد إحداثيات الجهاز من الخدمات المستندة إلى الموقع الجغرافي في المنصة واستدعاء ميزة "بحث في الجوار".
- الحصول على ملخّص نبذة باستخدام الذكاء الاصطناعي لمكان معيّن
- عرض ملخّص مستند إلى الذكاء الاصطناعي يصف الأماكن في المنطقة المحيطة بمكان معيّن
- عرض معلومات عن الأماكن استنادًا إلى سلسلة طلب بحث تقع على طول مسار محدّد مسبقًا
- عرض المسافة ومدة الرحلة وعنوان URI للاتجاهات إلى الأماكن التي تم البحث عنها نصيًا من مجموعة من إحداثيات خطوط العرض/الطول
- عرض المسافة ومدة الرحلة ومعرّف الموارد المنتظم (URI) للاتجاهات إلى الأماكن المجاورة من مجموعة من إحداثيات خطوط العرض/الطول
حزمة تطوير برامج الأماكن لأجهزة iOS: حزمة أدوات "خرائط Google" الجاهزة للأماكن
- تطبيق نمط CSS على عنصر في واجهة المستخدم لبيانات الأماكن ملاحظة: تنطبق الخصائص المخصّصة في CSS على عناصر حزمة أدوات "خرائط Google" الجاهزة للأماكن في Maps JavaScript API. أمّا حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل Android وحزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل iOS، فتصمّمان طرق عرض حزمة أدوات "خرائط Google" الجاهزة للأماكن آليًا باستخدام سمات المظهر والنمط. متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- تخصيص تصميم وإعدادات عناصر واجهة المستخدم لبيانات الأماكن باستخدام أداة تخصيص عناصر واجهة المستخدم: ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض معلومات عن مكان معيّن على صفحة ويب أو تطبيق للأجهزة الجوّالة. ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض قائمة بالأماكن استنادًا إلى سلسلة طلب بحث إلى صفحة ويب. ملاحظة: تتوفّر هذه الميزة على كلّ من صفحات الويب (Maps JavaScript API) والتطبيقات على الأجهزة الجوّالة (Places SDK for Android وPlaces SDK for iOS). متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض قائمة بالأماكن القريبة من موقع جغرافي معيّن إلى صفحة ويب. ملاحظة: تتوفّر هذه الميزة على كلّ من صفحات الويب (Maps JavaScript API) والتطبيقات على الأجهزة الجوّالة (Places SDK for Android وPlaces SDK for iOS). متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- يمكنك إضافة عنصر أساسي في واجهة المستخدم للإكمال التلقائي إلى صفحة ويب أو تطبيق يعرض معرّفات الأماكن على Google استنادًا إلى سلسلة طلب بحث. ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq