مرجع فئة GfpالأماكنClient


نظرة عامة

الواجهة الرئيسية لحزمة SDK للأماكن.

يُستخدم هذا الخيار للبحث والحصول على تفاصيل حول الأماكن. يجب الوصول إلى هذا الصف من خلال طريقة [GMSPlaceClient المشتركة.

يجب استدعاء طرق GMSPLACESClient من سلسلة المحادثات الرئيسية فقط. سيؤدي طلب هذه الطرق من سلسلة محادثات أخرى إلى تحقيق استثناء أو سلوك غير محدّد. ما لم يتم تحديد غير ذلك، سيتم استدعاء جميع عمليات معاودة الاتصال في سلسلة المحادثات الرئيسية.

الوظائف المتاحة للجميع

(إلغاء)- lookUpPlaceID:callback:
 الاطّلاع على تفاصيل لأحد الأماكن
(إلغاء)- lookUpPhotosForPlaceID:callback:
 الحصول على البيانات الوصفية لما يصل إلى 10 صور مرتبطة بمكان.
(إلغاء)- loadPlacePhoto:callback:
 تحمّل الصورة لصورة معيّنة بأكبر حجم لها.
(إلغاء)- loadPlacePhoto:constrainedToSize:measure:callback:
 تحمّل الصورة لصورة معيّنة، ويتم تغيير حجمها لتلائم الأبعاد القصوى المحدّدة.
(إلغاء)- PlacePlaceWithCallback:
 يعرض تقديرًا للمكان الذي يُعرف فيه الجهاز بأنّه متوفر حاليًا.
(إلغاء)- findAutocompletePredictionFromQuery:filter:sessionToken:callback:
 يمكنك العثور على عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" في طلب بحث نصي.
(إلغاء)- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 جلب تفاصيل لأحد الأماكن.
(إلغاء)- findPlacelikelili المنتدىsFromCurrentLocationWithPlaceFields:callback:
 حدِّد الاحتمالات المتعلّقة بالمكان باستخدام الموقع الجغرافي الحالي للمستخدم.

الوظائف الثابتة المتاحة للجميع

(المثيل الأصلي)+ sharedClient
 يوفّر المثيل المشترك GMSPlaceClient لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS، ويتم إنشاؤه إذا لزم الأمر.
(منطقي)+ provideAPIKey:
 يقدم مفتاح واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.
(سلسلة سلسلة *)+ openSourceSourceInfo
 تعرض معلومات ترخيص البرامج المفتوحة المصدر لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.
(سلسلة سلسلة *)+ SDKVersion
 عرض إصدار هذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.
(سلسلة سلسلة *)+ SDKlongVersion
 يعرض الإصدار الطويل من هذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

(يُرجى ملاحظة أنّ هذه الدوال ليست أعضاء).

typedef blank(^ )GMSPlaceResultCallback )(GMSPlace *_Nullable، خطأ _Nullable NS
 نوع معاودة الاتصال لعمليات البحث عن تفاصيل المكان
typedef blank(^ )GMSPlacelikeliholdListCallback )(GMSPlacelikeliholdList *_NullableاحتمالList، NSخطأ *_Nullable خطأ)
 نوع معاودة الاتصال لتلقّي قوائم احتمالية وجود المكان.
typedef blank(^ )GMSPlacelikelilissCallback )(NSArray< GMSPlacelikelihood * > *_Nullableاحتمالات، NSError *_Nullable خطأ)
 نوع معاودة الاتصال لتلقّي صفيف من GMSPlaceLikelihood.
typedef blank(^ )GMSAutocompletePrediction )(NSArray< GMSAutocompletePrediction * > *_Nullable النتائج، NSError *_Nullable خطأ)
 نوع معاودة الاتصال لتلقّي نتائج الإكمال التلقائي.
typedef blank(^ )GMSPlacePhotometadataCallCallback )(GMSPlacePhotoMetadataList *_Nullable photos، NSError *_Nullable error)
 نوع معاودة الاتصال لتلقّي نتائج صور المكان
typedef blank(^ )GMSPlaceالصورImageCallback )(UIImage *_Nullable Photo, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقّي عناصر UIImage من عنصر GMSPlacePhotoMetadata.

مستندات وظائف الأعضاء

+ (instancetype) sharedClient

يوفّر المثيل المشترك GMSPlaceClient لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS، ويتم إنشاؤه إذا لزم الأمر.

إذا كان تطبيقك يستخدم غالبًا طرق GMSPLACESClient، قد يحتاج إلى الاحتفاظ بهذا العنصر مباشرةً، وإلا قد تتم إعادة تشغيل الاتصال بـ Google على أساس منتظم.

+ (BOOL) provideAPIKey: (سلسلة سلسلة *) مفتاح

يقدم مفتاح واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

يتم إنشاء هذا المفتاح لتطبيقك من خلال "وحدة تحكّم Google Cloud Platform"، ويتم إقرانه مع معرِّف حزمة التطبيق لتعريفه. يجب أن يطلب ذلك تطبيقك قبل استخدام GMSPlaceClient (على سبيل المثال، in application:didFinishLaunchingWithOptions:).

طلبات الإرجاع:
نعم في حال توفير مفتاح واجهة برمجة التطبيقات بنجاح.
+ (NSString *) openSource licenseInfo

تعرض معلومات ترخيص البرامج المفتوحة المصدر لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

يجب إتاحة هذه المعلومات في تطبيقك.

+ (NSString *) SDKVersion

عرض إصدار هذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

على سبيل المثال، "1.0.0".

+ (NSString *) SDKlongVersion

يعرض الإصدار الطويل من هذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

على سبيل المثال، "1.0.0 (102.1).

- (باطل) (سلسلة سلسلة *) placeID
معاودة الاتصال: (GMSPlaceResultCallback) رد الاتصال

الاطّلاع على تفاصيل لأحد الأماكن

هذه الطريقة لا تحظر المحتوى.

المَعلمات:
رقم تعريف المكانرقم تعريف المكان للبحث.
معاودة الاتصالاستدعاء لاستدعاء نتيجة البحث
- (إبطال) LookupPhotosForPlaceID: (سلسلة سلسلة *) placeID
معاودة الاتصال: (GMSPlacePhotometadataMetadataCallback) رد الاتصال

الحصول على البيانات الوصفية لما يصل إلى 10 صور مرتبطة بمكان.

يتم الحصول على الصور من مجموعة متنوعة من المواقع، بما في ذلك مالكو الأنشطة التجارية والصور التي يساهم بها مستخدمو +Google. وفي معظم الحالات، يمكن استخدام هذه الصور بدون إسناد أو تضمين الإحالة المطلوبة كجزء من الصورة. ومع ذلك، عليك استخدام السمة attributions في الاستجابة لاسترداد أي عمليات إحالة إضافية مطلوبة، وعرض هذه السمات في تطبيقك أينما تعرض الصورة. يتم عرض 10 صور كحد أقصى.

وقد تؤدي المكالمات المتعددة لهذه الطريقة إلى عرض الصور نفسها في كل مرة. ومع ذلك، لا يمكن ضمان ذلك لأن البيانات الأساسية قد تغيّرت.

تعمل هذه الطريقة على إجراء بحث عن الشبكة.

المَعلمات:
رقم تعريف المكانرقم تعريف المكان للبحث عن الصور فيه.
معاودة الاتصالاستدعاء لاستدعاء نتيجة البحث
- (تفريغ)LoadPlacePhoto: (GMSPlacePhotoMetadata *) photometadata
معاودة الاتصال: (GMSPlacePhotoImageResultCallback) رد الاتصال

تحمّل الصورة لصورة معيّنة بأكبر حجم لها.

يمكن تخزين بيانات الصورة مؤقتًا من خلال حزمة تطوير البرامج (SDK). إذا لم تكن الصورة المطلوبة متوفّرة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.

المَعلمات:
البيانات الوصفية للصورGMSPlacePhotoMetadata التي يجب تحميل UIImage لها.
معاودة الاتصالاستدعاء استدعاء مع UIImage الذي تم تحميله.
- (تفريغ)LoadPlacePhoto: (GMSPlacePhotoMetadata *) photometadata
مقيَّد بالحجم: (CGSize) maxSize
التطوّر: (CGFloat) المقياس
معاودة الاتصال: (GMSPlacePhotoImageResultCallback) رد الاتصال

تحمّل الصورة لصورة معيّنة، ويتم تغيير حجمها لتلائم الأبعاد القصوى المحدّدة.

وسيتمّ تعديل حجم الصورة بحيث تتناسب مع الأبعاد المحدّدة مع الحفاظ على نسبة العرض إلى الارتفاع للصورة الأصلية. يتم تنفيذ هذا التحجيم من جهة الخادم.

وإذا لم تكن معلّمة المقياس 1.0 maxمضروبة في هذه القيمة، وسيتم ضبط UIImage المعروضة على المقياس المحدّد. يجب ضبط هذه المَعلمة على مقياس الشاشة إذا كنت تحمِّل صورًا لعرضها على الشاشة.

يمكن تخزين بيانات الصورة مؤقتًا من خلال حزمة تطوير البرامج (SDK). إذا لم تكن الصورة المطلوبة متوفّرة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.

ملاحظة:
بعد تطبيق عامل القياس، سيتم تقريب الأبعاد في maxSize إلى أقرب عدد صحيح قبل الاستخدام. وإذا تم طلب صورة أكبر من الحد الأقصى للحجم المتاح، قد يتم عرض صورة أصغر.
المَعلمات:
البيانات الوصفية للصورGMSPlacePhotoMetadata التي يجب تحميل UIImage لها.
الحد الأقصى للحجمالحد الأقصى لحجم الصورة.
المقياسالحجم الذي سيتم تحميل الصورة به.
معاودة الاتصالاستدعاء استدعاء مع UIImage الذي تم تحميله.

يعرض تقديرًا للمكان الذي يُعرف فيه الجهاز بأنّه متوفر حاليًا.

يتم إنشاء قائمة احتمالية المكان استنادًا إلى آخر موقع جغرافي مقدّر للجهاز. سيتم استدعاء معاودة الاتصال المقدَّمة من خلال قائمة الاحتمالات هذه عند نجاح الإجراء وNSError عند حدوث خطأ.

ملاحظة:
تتطلب هذه الطريقة حصول تطبيقك على إذن بالوصول إلى الموقع الجغرافي الحالي للجهاز. وقبل اتّباع هذه الخطوة، تأكَّد من طلب الوصول إلى الموقع الجغرافي للمستخدمين باستخدام [CLLocationManager request whenInUseUsage] أو [CLLocationManager requestدائمAuthentication]. وإذا استخدمت هذه الطريقة ولم يكن للتطبيق حالة التفويض الصحيحة، سيتم طلب معاودة الاتصال وستظهر رسالة خطأ.
المَعلمات:
معاودة الاتصالاستدعاء استدعاء قائمة احتمالية المكان
- (بدون) البحث عن عبارات البحث المقترحة من توقّع الإكمال التلقائي: (سلسلة سلسلة *) طلب بحث
الفلتر المستخدم: (حقل الإكمال التلقائي لبرنامج MSMS *) الفلتر
الرمز المميز للجلسة: (رمز GMSAutocompleteSessionToken *) sessionToken
معاودة الاتصال: (توقّعات الإكمال التلقائي في GMS) رد الاتصال

يمكنك العثور على عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" في طلب بحث نصي.

قد يتم انحياز النتائج اختياريًا في موقع جغرافي معيّن أو عرضها في منطقة معيّنة. هذه الطريقة لا تحظر المحتوى.

سيتم استدعاء رد الاتصال المقدّم من خلال مجموعة من عبارات البحث المقترحة من خلال الإكمال التلقائي عند النجاح ورمز NSError عند حدوث خطأ.

المَعلمات:
queryالنص الجزئي المطلوب إكماله تلقائيًا.
filterالفلتر المطلوب تطبيقه على النتائج. قد تكون هذه المعلمة خالية من الأخطاء.
الرمز المميز للجلسةGMSAutocompleteSessionToken لربط طلب بجلسة فوترة.
معاودة الاتصالاستدعاء لاستدعاء التوقعات.
- (بدون) الجلب المُقدَّم للمكان: (سلسلة سلسلة *) placeID
FieldFields: (GMSPlaceField) placeFields
الرمز المميز للجلسة: (رمز GMSAutocompleteSessionToken *) sessionToken
معاودة الاتصال: (GMSPlaceResultCallback) رد الاتصال

جلب تفاصيل لأحد الأماكن.

هذه الطريقة لا تحظر المحتوى.

المَعلمات:
رقم تعريف المكانرقم تعريف المكان للبحث.
وسيظهر في الحقولحقول الأماكن الفردية المطلوبة لعناصر المكان في القائمة
الرمز المميز للجلسةGMSAutocompleteSessionToken لربط طلب بجلسة فوترة.
معاودة الاتصالاستدعاء لاستدعاء نتيجة البحث
- (إعلانات فارغة) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
معاودة الاتصال: (GMSPlaceExampleliholdsCallback) رد الاتصال

حدِّد الاحتمالات المتعلّقة بالمكان باستخدام الموقع الجغرافي الحالي للمستخدم.

هذه الطريقة لا تحظر المحتوى.

سيتم استدعاء معاودة الاتصال المزوَّدة بها مجموعة من الأماكن التي يُحتمل أن تحمل تقييمًا للاحتمالية وخطأ NSError عند حدوث خطأ.

المَعلمات:
وسيظهر في الحقولحقول الأماكن الفردية المطلوبة لعناصر المكان في القائمة
معاودة الاتصالمعاودة الاتصال لاستدعاء احتمالات المكان.

- (typedef empty(^ GMSPlaceResultCallback)(GMSPlace *_Nullable ، خطأ NSError *_Nullable خطأ) [related]

نوع معاودة الاتصال لعمليات البحث عن تفاصيل المكان

في حال حدوث خطأ، سيتم استبدال result وسيتضمّن error معلومات حول الخطأ.

المَعلمات:
نتيجةGMSPlace التي تم إرجاعها
errorالخطأ الذي حدث، إن وجد.
- (typedef empty(^ GMSPlacelikeliholdListCallback)(GMSPlacelikeliliListList *_NullableabilityList, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي قوائم احتمالية وجود المكان.

في حال حدوث خطأ، سيتم استبدال likelihoodList وسيتضمّن error معلومات حول الخطأ.

المَعلمات:
قائمة احتماليةقائمة احتمالية المكان.
errorالخطأ الذي حدث، إن وجد.
- (typedef empty(^ GMSPlacelikelilissCallback)(NSArray< GMSPlacelikelilane * > *_Nullableاحتمالات، NSError *_Nullable خطأ) [related]

نوع معاودة الاتصال لتلقّي صفيف من GMSPlaceLikelihood.

في حال حدوث خطأ، ستكون الصفيف صفرًا وستحتوي error على معلومات عن الخطأ.

- (typedef blank(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable نتائج، NSError *_Nullable خطأ) [related]

نوع معاودة الاتصال لتلقّي نتائج الإكمال التلقائي.

results هي مجموعة من توقّعات الإكمال التلقائي من {9/} تمثّل عدد مرات إكمال طلب البحث.

المَعلمات:
نتائجمصفوفة من GMSAutocompletePrediction.
errorالخطأ الذي حدث، إن وجد.
- (typedef empty(^ GMSPlace PhotoMetadataCallCallback)(GMSPlacePhotoMetadataList *_Nullable الصور، NSError *_Nullable خطأ) [related]

نوع معاودة الاتصال لتلقّي نتائج صور المكان

في حال حدوث خطأ، سيتم استبدال photos وسيتضمّن error معلومات حول الخطأ.

المَعلمات:
صورالنتيجة التي تحتوي على GMSPlacePhotoMetadata عنصر.
errorالخطأ الذي حدث، إن وجد.
- (typedef empty(^ GMSPlaceImageImageCallback))(UIImage *_Nullable Photo, NSError *_Nullable error) [related]

نوع معاودة الاتصال لتلقّي عناصر UIImage من عنصر GMSPlacePhotoMetadata.

في حال حدوث خطأ، سيتم استبدال photo وسيتضمّن error معلومات حول الخطأ.

المَعلمات:
صورةتم تحميل UIImage.
errorالخطأ الذي حدث، إن وجد.