مرجع فئة GMSPlacesClient


نظرة عامة

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

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

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

وظائف الأعضاء العامين

(void) - lookUpPlaceID:callback:
 الحصول على تفاصيل عن مكان
(void) - lookUpPhotosForPlaceID:callback:
 يمكنك الحصول على البيانات الوصفية لما يصل إلى 10 صور مرتبطة بالمكان.
(void) - loadPlacePhotos:callback:
 لتحميل الصورة لصورة معينة بالحد الأقصى للحجم.
(void) - loadPlacePhoto:constrainedToSize:scale:callback:
 لتحميل الصورة لصورة معينة، يتم تغيير حجمها لتلائم الحد الأقصى للأبعاد المحددة.
(void) - currentPlaceWithCallback:
 لعرض تقدير للمكان المعروف وجود الجهاز فيه حاليًا.
(void) - findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 العثور على عبارات بحث مقترحة من خلال ميزة "الإكمال التلقائي" من طلب البحث النصي
(void) - fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 يمكنك استرجاع تفاصيل مكان معيّن.
(void) - findPlace LikeliwardsFromCurrentLocationWithPlaceFields:callback:
 ابحث عن احتمالات الأماكن باستخدام الموقع الجغرافي الحالي للمستخدم.
(void) - isOpenWithPlaceID:callback:
 يمكن الحصول على تفاصيل مكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.
(void) - isOpenWithPlaceID:date:callback:
 الحصول على تفاصيل مكان بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate محدّد
(void) - isOpenWithPlace:callback:
 يمكن الحصول على تفاصيل مكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.
(void) - isOpenWithPlace:date:callback:
 الحصول على تفاصيل مكان بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate محدّد

دوال الأعضاء العامة الثابتة

(instancetype)+ sharedClient
 تقدم النسخة الافتراضية المشتركة من GMSPlacesClient لحزمة SDK لأماكن Google لنظام التشغيل iOS، ويتم إنشاؤها إذا لزم الأمر.
(BOOL) + تقديم واجهة برمجة التطبيقات:
 توفر مفتاح واجهة برمجة التطبيقات لحزمة تطوير برامج أماكن Google لنظام التشغيل iOS.
(NSString *)+ openSourceLicenseInfo
 عرض معلومات ترخيص البرنامج مفتوح المصدر لحزمة تطوير برامج أماكن Google لنظام التشغيل iOS.
(NSString *)+ SDKVersion
 عرض نسخة هذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.
(NSString *)+ SDKLongVersion
 عرض النسخة الطويلة لهذا الإصدار من حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

(لاحظ أن هذه ليست دوال أعضاء.)

typedef void(^ GMSPlaceResultCallback )(GMSPlace *_Nullable result, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقي عمليات البحث عن تفاصيل المكان.
typedef void(^ GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_NullableabilitiesList, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقي قوائم احتمالية الأماكن.
typedef void(^ GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullableabilities, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقّي مصفوفة من GMSPlaceLikelihoods.
typedef void(^ GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقي نتائج الإكمال التلقائي.
typedef void(^ GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقي نتائج صور الأماكن.
typedef void(^ GMSPlacePhotoImageResultCallback )(UIImage *_Nullable photos, NSError *_Nullable error)
 نوع معاودة الاتصال لاستلام عناصر UIImage من عنصر GMSPlacePhotoMetadata.
typedef void(^ GMSPlaceOpenStatusCallback )(نتيجة GMSPlaceOpenStatus, NSError *_Nullable error)
 نوع معاودة الاتصال لتلقي حالة ساعات العمل للمكان.

وثائق وظائف الأعضاء

+ (instancetype) sharedClient

تقدم النسخة الافتراضية المشتركة من GMSPlacesClient لحزمة SDK لأماكن Google لنظام التشغيل iOS، ويتم إنشاؤها إذا لزم الأمر.

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

+ (BOOL) توفير APIKey: (NSString *) مفتاح

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

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

المرتجعات:
نعم إذا تم تقديم APIKey بنجاح.
+ (NSString *) openSourceLicenseInfo

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

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

+ (NSString *) SDKVersion

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

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

+ (NSString *) SDKLongVersion

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

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

- (void) lookUpPlaceID: (NSString *) placeID
رد الاتصال: (GMSPlaceResultCallback) معاودة الاتصال

الحصول على تفاصيل عن مكان

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
placeIDرقم تعريف المكان المطلوب البحث فيه.
رد الاتصالتمثّل هذه السمة معاودة الاتصال المطلوب استدعاؤها بنتيجة البحث.
- (void) lookUpPhotosForPlaceID: (NSString *) placeID
رد الاتصال: (GMSPlacePhotoMetadataResultCallback) معاودة الاتصال

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

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

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

وتُجري هذه الطريقة بحثًا عن الشبكة.

المَعلمات:
placeIDرقم تعريف المكان المطلوب البحث عن الصور بشأنه.
رد الاتصالتمثّل هذه السمة معاودة الاتصال المطلوب استدعاؤها بنتيجة البحث.
- (void) uploadPlacePhotos: (GMSPlacePhotoMetadata *) photoMetadata
رد الاتصال: (GMSPlacePhotoImageResultCallback) معاودة الاتصال

لتحميل الصورة لصورة معينة بالحد الأقصى للحجم.

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

المَعلمات:
photoMetadataGMSPlacePhotoMetadata المطلوب تحميل UIImage لها.
رد الاتصالمعاودة الاتصال المطلوب استدعاءها مع UIImage التي تم تحميلها.
- (void) uploadPlacePhotos: (GMSPlacePhotoMetadata *) photoMetadata
ideedToSize: (CGSize) maxSize
المقياس: (CGFloat) مقياس
رد الاتصال: (GMSPlacePhotoImageResultCallback) معاودة الاتصال

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

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

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

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

ملاحظة:
بعد تطبيق عامل المقياس، سيتم تقريب الأبعاد في maxSize إلى أقرب عدد صحيح قبل الاستخدام. في حال طلب صورة بحجم أكبر من الحد الأقصى للحجم المتاح، قد يتم عرض صورة أصغر حجمًا.
المَعلمات:
photoMetadataGMSPlacePhotoMetadata المطلوب تحميل UIImage لها.
maxSizeالحد الأقصى لحجم الصورة.
تحجيمالمقياس المراد تحميل الصورة به.
رد الاتصالمعاودة الاتصال المطلوب استدعاءها مع UIImage التي تم تحميلها.
- (باطل) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) معاودة الاتصال

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

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

ملاحظة:
تتطلب هذه الطريقة أن يكون لدى تطبيقك إذن بالوصول إلى الموقع الجغرافي الحالي للجهاز. قبل استدعاء هذه الرسالة، تأكَّد من طلب الوصول إلى الموقع الجغرافي للمستخدمين باستخدام [CLLocationManager requestWhenInUse تبديل] أو [CLLocationManager requestLoAuthorize]. في حال استدعيت هذه الطريقة ولم يتم منح تطبيقك حالة التفويض الصحيحة، سيتم استدعاء معاودة الاتصال مع ظهور خطأ.
المَعلمات:
رد الاتصالمعاودة الاتصال المطلوب استدعاؤها مع قائمة احتمالية الأماكن.
- (void) findAutocompleteForecastionsFromQuery: (NSString *) طلب البحث
الفلتر المستخدم: (GMSAutocompleteFilter *) قابل للقيم فلتر
sessionToken: (GMSAutocompleteSessionToken *) قابل للقيم الفارغة sessionToken
رد الاتصال: (GMSAutocompletePredictionsCallback) معاودة الاتصال

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

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

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

المَعلمات:
queryجزء النص المطلوب إكماله تلقائيًا.
filterالفلتر المطلوب تطبيقه على النتائج. قد تكون هذه المعلمة صفرية.
sessionTokenGMSAutocompleteSessionToken لربط الطلب بجلسة فوترة.
رد الاتصالمعاودة الاتصال التي سيتم الاستدعاء لها مع عبارات البحث المقترحة.
- (void) fetchPlaceFromPlaceID: (NSString *) placeID
مجالات الأماكن: (GMSPlaceField) placeFields
sessionToken: (GMSAutocompleteSessionToken *) قابل للقيم الفارغة sessionToken
رد الاتصال: (GMSPlaceResultCallback) معاودة الاتصال

يمكنك استرجاع تفاصيل مكان معيّن.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
placeIDرقم تعريف المكان المطلوب البحث فيه.
placeFieldsحقول الأماكن الفردية المطلوبة لعناصر الأماكن في القائمة.
sessionTokenGMSAutocompleteSessionToken لربط الطلب بجلسة فوترة.
رد الاتصالتمثّل هذه السمة معاودة الاتصال المطلوب استدعاؤها بنتيجة البحث.
- (void) findPlacelikeliagesFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
رد الاتصال: (GMSPlaceLikelihoodsCallback) معاودة الاتصال

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

لا تؤدي هذه الطريقة إلى الحظر.

سيتم استدعاء استدعاء الاستدعاء المقدم مع مجموعة من الأماكن التي لها تقييمات للاحتمالات عند نجاحها وNSError عند حدوث خطأ.

المَعلمات:
placeFieldsحقول الأماكن الفردية المطلوبة لعناصر الأماكن في القائمة.
رد الاتصالمعاودة الاتصال المطلوب استدعاءها مع احتمالات الأماكن.
- (خالي) isOpenWithPlaceID: (NSString *) placeID
رد الاتصال: (GMSPlaceOpenStatusCallback) معاودة الاتصال

يمكن الحصول على تفاصيل مكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
placeIDرقم تعريف المكان المطلوب البحث فيه.
رد الاتصالمعاودة الاتصال المطلوب الاستدعاء لها مع نتيجة المكان.
- (خالي) isOpenWithPlaceID: (NSString *) placeID
التاريخ: (NSDate *) التاريخ
رد الاتصال: (GMSPlaceOpenStatusCallback) معاودة الاتصال

الحصول على تفاصيل مكان بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate محدّد

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
placeIDرقم تعريف المكان المطلوب البحث فيه.
التاريختمثّل هذه السمة NSDate لتحديد حالة "مفتوح" لها.
رد الاتصالمعاودة الاتصال المطلوب الاستدعاء لها مع نتيجة المكان.
- (خالي) isOpenWithPlace: (GMSPlace *) مكان
رد الاتصال: (GMSPlaceOpenStatusCallback) معاودة الاتصال

يمكن الحصول على تفاصيل مكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.

يتم طلب حقول إضافية فقط إذا لم يتم توفير جميع الحقول اللازمة في الحقل GMSPlace، وإلّا سيتم عرض GMSPlaceOpenStatus في معاودة الاتصال على الفور. لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:
مكانتمثّل هذه السمة GMSPlace للبحث.
رد الاتصالمعاودة الاتصال المطلوب الاستدعاء لها مع نتيجة المكان.
- (خالي) isOpenWithPlace: (GMSPlace *) مكان
التاريخ: (NSDate *) التاريخ
رد الاتصال: (GMSPlaceOpenStatusCallback) معاودة الاتصال

الحصول على تفاصيل مكان بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate محدّد

يتم طلب حقول إضافية فقط إذا كانت السمة GMSPlace لا تحتوي على جميع الحقول اللازمة، وإلا سيتم طلب GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking. .

Parameters:
placeThe GMSPlace to lookup.
dateThe NSDate to determine open status for.
callbackThe callback to invoke with the place result.


- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

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

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

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

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

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

المَعلمات:
likelihoodListتمثّل هذه السمة قائمة باحتمالات الأماكن.
خطأالخطأ الذي حدث، إن وجد.
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullableإزعاج, NSError *_Nullable error)) [related]

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

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

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

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

results هي صفيف من GMSAutocompleteForecastions تمثل إكمالات البحث المقترحة لطلب البحث.

المَعلمات:
نتائجمصفوفة من GMSAutocompletePredictions.
خطأالخطأ الذي حدث، إن وجد.
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]

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

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

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

نوع معاودة الاتصال لاستلام عناصر UIImage من عنصر GMSPlacePhotoMetadata.

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

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

نوع معاودة الاتصال لتلقي حالة ساعات العمل للمكان.

إذا حدث خطأ، سيتم استبدال result بالرمز GMSPlaceOpenStatusUnknown وسيحتوي على معلومات حول الخطأ error.

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