نظرة عامة

الواجهة الرئيسية لحزمة 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:
	حدِّد الاحتمالات المتعلّقة بالمكان باستخدام الموقع الجغرافي الحالي للمستخدم.
(إلغاء)	- isOpenWithPlaceID:callback:
	يمكنك الحصول على تفاصيل لأحد الأماكن بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في الوقت الحالي.
(إلغاء)	- isOpenWithPlaceID:date:callback:
	يمكنك الحصول على تفاصيل لأحد الأماكن، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في السمة `NSDate` المحدّدة.
(إلغاء)	- isOpenWithPlace:callback:
	يمكنك الحصول على تفاصيل لأحد الأماكن بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في الوقت الحالي.
(إلغاء)	- isOpenWithPlace:date:callback:
	يمكنك الحصول على تفاصيل لأحد الأماكن، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في السمة `NSDate` المحدّدة.
الوظائف الثابتة المتاحة للجميع
(المثيل الأصلي)	+ 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`.
typedef blank(^ )	GMSPlaceOpenStatusCallback )(GMSPlaceOpenStatus، خطأ NSError *_Nullable)
	نوع معاودة الاتصال لتلقّي حالة ساعات العمل للمكان.

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

+ (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` الذي تم تحميله.

- (ملغى) currentPlaceWithCallback: (GMSPlaceExampleliholdListCallback) رد الاتصال

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

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

المَعلمات:

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

- (خالٍ) isOpenWithPlaceID:	(سلسلة سلسلة *)	placeID
معاودة الاتصال:	(GMSPlaceOpenStatusCallback)	رد الاتصال

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

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

المَعلمات:

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

- (خالٍ) isOpenWithPlaceID:	(سلسلة سلسلة *)	placeID
التاريخ:	(NSDate *)	التاريخ
معاودة الاتصال:	(GMSPlaceOpenStatusCallback)	رد الاتصال

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

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

المَعلمات:

رقم تعريف المكان	رقم تعريف المكان للبحث.
التاريخ	علامة `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:

  
    place The GMSPlace to lookup. 
    date The NSDate to determine open status for. 
    callback The callback to invoke with the place result.

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

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

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

المَعلمات:

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

- (typedef empty(^ GMSPlacelikeliholdListCallback)(GMSPlacelikeliliListList *_NullableabilityList, NSError *_Nullable error)) [related]

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

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

المَعلمات:

قائمة احتمالية	قائمة احتمالية المكان.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef empty(^ GMSPlacelikelilissCallback)(NSArray< GMSPlacelikelilane * > *_Nullableاحتمالات، NSError *_Nullable خطأ) [related]

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

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

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

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

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

المَعلمات:

نتائج	مصفوفة من `GMSAutocompletePrediction`.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef empty(^ GMSPlace PhotoMetadataCallCallback)(GMSPlacePhotoMetadataList *_Nullable الصور، NSError *_Nullable خطأ) [related]

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

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

المَعلمات:

صور	النتيجة التي تحتوي على `GMSPlacePhotoMetadata` عنصر.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef empty(^ GMSPlaceImageImageCallback))(UIImage *_Nullable Photo, NSError *_Nullable error) [related]

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

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

المَعلمات:

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

- (typedef blank(^ GMSPlaceOpenStatusCallback)(GMSPlaceOpenStatus, NSError *_Nullable error) [related]

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

في حال حدوث خطأ، ستكون القيمة resultPlacePlaceOpenStatus غير معروفة وسيتضمّن error معلومات حول الخطأ.

المَعلمات:

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

place	The `GMSPlace` to lookup.
date	The `NSDate` to determine open status for.
callback	The callback to invoke with the place result.

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

نظرة عامة

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

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

الدوال ذات الصلة

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

مستندات الأصدقاء والوظائف ذات الصلة