نظرة عامة
الواجهة الرئيسية لحزمة تطوير برامج الأماكن.
يُستخدم للبحث عن الأماكن والحصول على تفاصيل عنها. ويجب الوصول إلى هذه الفئة من خلال طريقة [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) |
نوع معاودة الاتصال لتلقّي مصفوفة من GMSPlaceLikelihood s. | |
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). إذا لم تتوفر الصورة المطلوبة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.
- المَعلمات:
-
photoMetadata GMSPlacePhotoMetadata
المطلوب تحميلUIImage
لها.رد الاتصال معاودة الاتصال المطلوب استدعاءها مع UIImage
التي تم تحميلها.
- (void) uploadPlacePhotos: | (GMSPlacePhotoMetadata *) | photoMetadata | |
ideedToSize: | (CGSize) | maxSize | |
المقياس: | (CGFloat) | مقياس | |
رد الاتصال: | (GMSPlacePhotoImageResultCallback) | معاودة الاتصال | |
لتحميل الصورة لصورة معينة، يتم تغيير حجمها لتلائم الحد الأقصى للأبعاد المحددة.
سيتم تغيير حجم الصورة لتلائم الأبعاد المحددة مع الحفاظ على نسبة العرض إلى الارتفاع للصورة الأصلية. يتم تنفيذ هذا التحجيم من جهة الخادم.
إذا لم تكن مَعلمة المقياس 1.0 maxSize، سيتم ضرب هذه القيمة في هذه القيمة، وسيتم ضبط قيمة UIImage
المعروضة بحيث تتضمّن المقياس المحدّد. يجب ضبط هذه المَعلمة على مقياس الشاشة في حال تحميل صور لعرضها على الشاشة.
يمكن أن يتم تخزين بيانات الصور مؤقتًا بواسطة حزمة تطوير البرامج (SDK). إذا لم تتوفر الصورة المطلوبة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.
- ملاحظة:
- بعد تطبيق عامل المقياس، سيتم تقريب الأبعاد في maxSize إلى أقرب عدد صحيح قبل الاستخدام. في حال طلب صورة بحجم أكبر من الحد الأقصى للحجم المتاح، قد يتم عرض صورة أصغر حجمًا.
- المَعلمات:
-
photoMetadata GMSPlacePhotoMetadata
المطلوب تحميلUIImage
لها.maxSize الحد الأقصى لحجم الصورة. تحجيم المقياس المراد تحميل الصورة به. رد الاتصال معاودة الاتصال المطلوب استدعاءها مع UIImage
التي تم تحميلها.
- (باطل) currentPlaceWithCallback: | (GMSPlaceLikelihoodListCallback) | معاودة الاتصال |
لعرض تقدير للمكان المعروف وجود الجهاز فيه حاليًا.
ينشئ قائمة احتمالية الأماكن استنادًا إلى آخر موقع جغرافي مقدَّر للجهاز. سيتم استدعاء استدعاء الاستدعاء الذي تم توفيره مع قائمة الاحتمالات هذه عند نجاح الإجراء وعرض NSError عند حدوث خطأ.
- ملاحظة:
- تتطلب هذه الطريقة أن يكون لدى تطبيقك إذن بالوصول إلى الموقع الجغرافي الحالي للجهاز. قبل استدعاء هذه الرسالة، تأكَّد من طلب الوصول إلى الموقع الجغرافي للمستخدمين باستخدام [CLLocationManager requestWhenInUse تبديل] أو [CLLocationManager requestLoAuthorize]. في حال استدعيت هذه الطريقة ولم يتم منح تطبيقك حالة التفويض الصحيحة، سيتم استدعاء معاودة الاتصال مع ظهور خطأ.
- المَعلمات:
-
رد الاتصال معاودة الاتصال المطلوب استدعاؤها مع قائمة احتمالية الأماكن.
- (void) findAutocompleteForecastionsFromQuery: | (NSString *) | طلب البحث | |
الفلتر المستخدم: | (GMSAutocompleteFilter *) قابل للقيم | فلتر | |
sessionToken: | (GMSAutocompleteSessionToken *) قابل للقيم الفارغة | sessionToken | |
رد الاتصال: | (GMSAutocompletePredictionsCallback) | معاودة الاتصال | |
العثور على عبارات بحث مقترحة من خلال ميزة "الإكمال التلقائي" من طلب البحث النصي
قد تكون النتائج منحازة اختياريًا نحو موقع جغرافي معيّن أو مقتصرة على منطقة معيّنة. لا تؤدي هذه الطريقة إلى الحظر.
سيتم استدعاء استدعاء الاتصال المقدم مع مجموعة من توقعات الإكمال التلقائي عند النجاح وNSError عند حدوث خطأ.
- المَعلمات:
-
query جزء النص المطلوب إكماله تلقائيًا. filter الفلتر المطلوب تطبيقه على النتائج. قد تكون هذه المعلمة صفرية. sessionToken GMSAutocompleteSessionToken
لربط الطلب بجلسة فوترة.رد الاتصال معاودة الاتصال التي سيتم الاستدعاء لها مع عبارات البحث المقترحة.
- (void) fetchPlaceFromPlaceID: | (NSString *) | placeID | |
مجالات الأماكن: | (GMSPlaceField) | placeFields | |
sessionToken: | (GMSAutocompleteSessionToken *) قابل للقيم الفارغة | sessionToken | |
رد الاتصال: | (GMSPlaceResultCallback) | معاودة الاتصال | |
يمكنك استرجاع تفاصيل مكان معيّن.
لا تؤدي هذه الطريقة إلى الحظر.
- المَعلمات:
-
placeID رقم تعريف المكان المطلوب البحث فيه. placeFields حقول الأماكن الفردية المطلوبة لعناصر الأماكن في القائمة. sessionToken GMSAutocompleteSessionToken
لربط الطلب بجلسة فوترة.رد الاتصال تمثّل هذه السمة معاودة الاتصال المطلوب استدعاؤها بنتيجة البحث.
- (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:
-
place The GMSPlace
to lookup.
date The NSDate
to determine open status for.
callback The 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] |
نوع معاودة الاتصال لتلقّي مصفوفة من GMSPlaceLikelihood
s.
وإذا حدث خطأ، ستكون المصفوفة فارغة وتحتوي error
على معلومات حول الخطأ.
- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related] |
نوع معاودة الاتصال لتلقي نتائج الإكمال التلقائي.
results
هي صفيف من GMSAutocompleteForecastions تمثل إكمالات البحث المقترحة لطلب البحث.
- المَعلمات:
-
نتائج مصفوفة من GMSAutocompletePrediction
s.خطأ الخطأ الذي حدث، إن وجد.
- (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
التي تم إرجاعهاخطأ الخطأ الذي حدث، إن وجد.