جستجوی متن (جدید) اطلاعاتی درباره مجموعهای از مکانها بر اساس یک رشته (مثلاً «پیتزا در نیویورک» یا «کفشفروشیهای نزدیک اتاوا» یا «خیابان اصلی ۱۲۳») برمیگرداند. این سرویس با فهرستی از مکانهایی که با رشته متن مطابقت دارند و هرگونه سوگیری مکانی که تنظیم شده است، پاسخ میدهد.
علاوه بر پارامترهای مورد نیاز ، جستجوی متن (جدید) از اصلاح پرسوجوها با استفاده از پارامترهای اختیاری برای نتایج بهتر پشتیبانی میکند.
دریافت فهرست مکانها از طریق جستجوی متنی
با فراخوانی GMSPlacesClient searchByTextWithRequest: یک درخواست جستجوی متن ایجاد کنید و یک شیء GMSPlaceSearchByTextRequest که پارامترهای درخواست و یک متد callback از نوع GMSPlaceSearchByTextResultCallback را برای مدیریت پاسخ تعریف میکند، ارسال کنید.
شیء GMSPlaceSearchByTextRequest تمام پارامترهای مورد نیاز و اختیاری برای درخواست را مشخص میکند. پارامترهای مورد نیاز عبارتند از:
- فهرست فیلدهایی که باید در شیء
GMSPlaceبرگردانده شوند، که به آن field mask نیز گفته میشود، همانطور که توسطGMSPlacePropertyتعریف شده است. اگر حداقل یک فیلد را در فهرست فیلدها مشخص نکنید، یا اگر فهرست فیلدها را حذف کنید، فراخوانی خطا میدهد. - پرس و جوی متنی .
این نمونه درخواست جستجوی متن مشخص میکند که اشیاء GMSPlace پاسخ، شامل نام مکان و شناسه مکان برای هر شیء GMSPlace در نتایج جستجو هستند. همچنین پاسخ را فیلتر میکند تا فقط مکانهایی از نوع "رستوران" را برگرداند.
مکانهای Swift SDK
let restriction = GMSPlaceRectangularLocationOption( northEast: CLLocationCoordinate2D(latitude: 20, longitude: 30), southWest: CLLocationCoordinate2D(latitude: 40, longitude: 50) ) let searchByTextRequest = SearchByTextRequest( textQuery: "pizza in New York", placeProperties: [ .name, .placeID ], locationRestriction: restriction, includedType: .restaurant, maxResultCount: 5, minRating: 3.5, priceLevels: