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