المرجع السريع لحزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS

تتيح حزمة تطوير البرامج (SDK) للأماكن على أجهزة iOS لتطبيقات iOS الحصول على معلومات عن الأماكن (الأنشطة التجارية ونقاط الاهتمام والمواقع الجغرافية) من خلال تفاصيل المكان وصور المكان والبحث النصي والبحث في الجوار والإكمال التلقائي. ‫Places API (الإصدار الجديد) هو الإصدار الحالي من حزمة تطوير البرامج (SDK).

حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS: معلومات أساسية

حالات استخدام Places SDK for iOS

استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لتطبيقات iOS في الحالات التالية:

  • إذا كنت بحاجة إلى تفاصيل الأماكن أو الصور أو نتائج "البحث النصي" أو "البحث في الجوار" داخل تطبيق iOS أصلي
  • تحتاج إلى ميزة الإكمال التلقائي لاسم المكان أو عنوانه أثناء كتابة المستخدمين في تطبيق iOS.
  • إذا أردت استخدام مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن المُعدّة مسبقًا (تفاصيل المكان والبحث والإكمال التلقائي) في تطبيق iOS.

لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لتطبيقات iOS في الحالات التالية:

حزمة تطوير برامج الأماكن لأجهزة iOS: الإعداد

حِزم SDK الرسمية لـ "الأماكن" على أجهزة iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

حزمة تطوير برامج الأماكن لأجهزة 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) والإصدارات الأحدث، ما يؤدي إلى تعطُّل عملية التجميع. يُرجى الاطّلاع على دليل نقل البيانات.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner وGMSAutocompleteFetcher initWithBounds:filter: تم إيقافها نهائيًا منذ ‎13-10-2020. البديل: GMSAutocompleteFilter (locationBias أو locationRestriction) في GMSAutocompleteRequest مع GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:، أو المُعدِّلات GooglePlacesSwift placeAutocomplete أو 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) وGMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:، أو المُعدِّلات GooglePlacesSwift placeAutocomplete أو basicPlaceAutocomplete لعنصر واجهة مستخدم. المشكلة: لا تتوفّر السمات والمَعلمات في الإصدار 4.0.0 من حزمة SDK والإصدارات الأحدث (وتمّت إزالة GMSAutocompleteViewController وfindAutocompletePredictionsFromQuery في الإصدار 11.0.0 من حزمة SDK). يُرجى الاطّلاع على دليل نقل البيانات.
  • GMSPlace.openNowStatus: تم إيقافها نهائيًا منذ ‎13-10-2020. الاستبدال: GMSPlacesClient isOpenWithRequest: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: الذكاء الاصطناعي التوليدي

حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS: الأماكن

حزمة تطوير برامج الأماكن لأجهزة 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