تتيح "حزمة تطوير البرامج (SDK) للأماكن" لنظام التشغيل iOS (الإصدار القديم) استخدام ميزة الإكمال التلقائي لبيانات الأماكن (الإصدار القديم). إذا كنت على دراية بخدمة "الإكمال التلقائي للأماكن" (القديمة)، تُجري خدمة "الإكمال التلقائي" (الجديدة) التغييرات التالية:
يستخدم نموذج أسعار جديدًا. للحصول على معلومات عن أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على الاستخدام والفوترة.
لإرسال طلب، استخدِم طريقة
GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:الجديدة.يتم تمريرها إلى الطلب:
مثيل لفئة
GMSAutocompleteRequestالجديدة التي تحدّد جميع مَعلمات الطلب، مثل طلب البحث والرمز المميز للجلسة.دالة استدعاء من النوع
GMSAutocompleteSuggestionsCallbackللتعامل مع الاستجابة
تتيح لك فئة
GMSAutocompleteFilterالآن إجراء ما يلي:- يتم ضبط رمز المنطقة المستخدَم لتحديد تنسيق النتائج.
- تحديد إزاحة التوقّعات، وهي إزاحة أحرف Unicode المستندة إلى الصفر في طلب البحث.
يتم تحديد الاستجابة من خلال فئة
GMSAutocompleteSuggestionالجديدة. تحتوي هذه الفئة على مصفوفة من مثيلات النوع الجديدGMSAutocompletePlaceSuggestionالذي يمثّل الاقتراحات.تنتهي الجلسة الآن بطلب إلى تفاصيل المكان (جديد) أو Address Validation. لمزيد من المعلومات، يُرجى الاطّلاع على ميزة "الإكمال التلقائي" (الجديدة) وأسعار الجلسات.
مثال على الطلب
باستخدام ميزة "الإكمال التلقائي (جديد)"، يمكنك إرسال طلب وتمرير جميع المَعلمات في مثيل GMSAutocompleteRequest:
Swift
let token = GMSAutocompleteSessionToken()
let northEastBounds = CLLocationCoordinate2DMake(37.38816277477739, -122.08813770258874)
let southWestBounds = CLLocationCoordinate2DMake(37.39580487866437, -122.07702325966572)
let filter = GMSAutocompleteFilter()
filter.types = [kGMSPlaceTypeRestaurant]
filter.locationBias = GMSPlaceRectangularLocationOption(northEastBounds, southWestBounds)
let request = GMSAutocompleteRequest(query:"Sicilian piz")
request.filter = filter
request.sessionToken = token
GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { results, error in
// Handle response
})
Objective-C
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(37.38816277477739, -122.08813770258874);
CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(37.39580487866437, -122.07702325966572);
GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ kGMSPlaceTypeRestaurant ];
filter.locationBias = GMSPlaceRectangularLocationOption(northEast, southWest);
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Sicilian piz"];
request.sessionToken = token;
request.filter = filter;
[[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
// Handle response
for (GMSAutocompleteSuggestion *suggestion in results) {
if (suggestion.placeSuggestion) {
// Show place suggestion data.
}
}
}];