این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تکمیل خودکار مکان (جدید)

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت، وب سرویس

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

سرویس تکمیل خودکار (جدید) یک API iOS است که در پاسخ به یک درخواست، پیشنهاد مکان می‌دهد. در درخواست، یک رشته جستجوی متنی و مرزهای جغرافیایی که ناحیه جستجو را کنترل می‌کنند، مشخص کنید.

سرویس تکمیل خودکار (جدید) می‌تواند کلمات کامل و زیررشته‌های ورودی را تطبیق دهد و نام مکان‌ها، آدرس‌ها و کدهای پلاس را حل کند. بنابراین، برنامه‌ها می‌توانند همزمان با تایپ کاربر، پرس‌وجوهایی ارسال کنند تا پیشنهادهای مکان را در لحظه ارائه دهند.

پیشنهاد مکان ، مکان‌هایی مانند کسب‌وکارها، آدرس‌ها و نقاط مورد علاقه هستند که بر اساس رشته متن ورودی مشخص شده و ناحیه جستجو ارائه می‌شوند.

برای مثال، شما API را با استفاده از رشته‌ای که شامل بخشی از ورودی کاربر، "Spagh" است و ناحیه جستجو به شهر نیویورک محدود شده است، فراخوانی می‌کنید. سپس پاسخ شامل فهرستی از پیشنهادهای مکان است که با رشته جستجو و ناحیه جستجو مطابقت دارند، مانند رستورانی به نام "Cafe Spaghetti"، به همراه جزئیاتی در مورد مکان.

پیشنهادهای مکان‌های برگردانده شده به گونه‌ای طراحی شده‌اند که به کاربر ارائه شوند تا بتواند مکان مورد نظر خود را انتخاب کند. می‌توانید برای دریافت اطلاعات بیشتر در مورد هر یک از پیشنهادهای مکان برگردانده شده، درخواست « جزئیات مکان (جدید)» ارسال کنید.

شما می‌توانید قابلیت تکمیل خودکار (جدید) را به دو روش اصلی در برنامه خود ادغام کنید:

دریافت پیش‌بینی‌های مکان به صورت برنامه‌نویسی‌شده : مستقیماً API را فراخوانی کنید تا پیش‌بینی‌ها را بازیابی کرده و آن‌ها را در یک رابط کاربری سفارشی نمایش دهید.
ویجت تکمیل خودکار مکان را اضافه کنید : یک تجربه تکمیل خودکار جستجوی آماده برای استفاده ارائه می‌دهد که پیش‌بینی‌ها را همزمان با تایپ کاربر نمایش می‌دهد.

پیش‌بینی‌های مکان را به صورت برنامه‌نویسی‌شده دریافت کنید

تکمیل خودکار درخواست‌ها (جدید)

با فراخوانی یک متد در GMSPlacesClient ، یک درخواست تکمیل خودکار ایجاد کنید. می‌توانید پارامترها را در شیء GMSAutocompleteRequest ارسال کنید. پاسخ، پیشنهادات تکمیل خودکار را در یک شیء GMSAutocompletePlaceSuggestion ارائه می‌دهد.

کلید API و پارامترهای query الزامی هستند. همچنین می‌توانید GMSAutocompleteSessionToken برای مرتبط کردن درخواست‌ها با یک جلسه صورتحساب و GMSAutocompleteFilter برای اعمال روی نتایج، اضافه کنید.

نسخه SDK سوئیفت را قرار می‌دهد

با فراخوانی یک متد در PlacesClient یک درخواست تکمیل خودکار ایجاد کنید. می‌توانید پارامترها را در شیء AutocompleteRequest ارسال کنید. پاسخ، پیشنهادات تکمیل خودکار را در یک شیء AutocompletePlaceSuggestion ارائه می‌دهد.

کلید API و پارامترهای query الزامی هستند. همچنین می‌توانید AutocompleteSessionToken برای مرتبط کردن درخواست‌ها با یک جلسه صورتحساب و AutocompleteFilter برای اعمال روی نتایج، اضافه کنید.

برای اطلاعات بیشتر در مورد پارامترهای اجباری و اختیاری، به بخش پارامترهای این سند مراجعه کنید.

مکان‌های Swift SDK

let center = (37.3913916, -122.0879074)
let northEast = (37.388162, -122.088137)
let southWest = (37.395804, -122.077023)

let bias = RectangularCoordinateRegion(northEast: northEast, southWest: southWest)
let filter = AutocompleteFilter(types: [ .restaurant ], origin: center, coordinateRegionBias: bias)

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  // Handle suggestions.
case .failure(let placesError):
  // Handle error.
}

سویفت

let token = GMSAutocompleteSessionToken()

let northWestBounds = CLLocationCoordinate2DMake(40.921628, -73.700051)
let southEastBounds = CLLocationCoordinate2DMake(40.477398, -74.259087)

let filter = GMSAutocompleteFilter()
filter.types = [kGMSPlaceTypeRestaurant]
filter.locationBias = GMSPlaceRectangularLocationOption(northWestBounds, southEastBounds)

let request = GMSAutocompleteRequest(query:"Spagh")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

هدف-سی

CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(37.388162, -122.088137);
CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(37.395804, -122.077023);

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.
    }
  }
}];

پاسخ‌های تکمیل خودکار (جدید)

تابع تکمیل خودکار، آرایه‌ای شامل حداکثر پنج نمونه از GMSAutocompleteSuggestion را برمی‌گرداند. این آرایه شامل موارد زیر است:

placeID
types : انواعی که در مورد این مکان صدق می‌کنند.
distanceMeters : فاصله از مبدا.
attributedFullText : متن کامل و خوانا برای انسان از یک پیشنهاد.
attributedPrimaryText : متن اصلی قابل خواندن توسط انسان از یک پیشنهاد.
attributedSecondaryText : متن ثانویه‌ی قابل خواندن توسط انسان از یک پیشنهاد.
structuredFormat : نام خاص و متن ابهام‌زدایی، مانند شهر یا منطقه.

پارامترهای مورد نیاز

پرس و جو

رشته متنی که جستجو روی آن انجام می‌شود. کلمات کامل و زیررشته‌ها، نام مکان‌ها، آدرس‌ها و کدهای اضافی را مشخص کنید. سرویس تکمیل خودکار (جدید) تطابق‌های کاندید را بر اساس این رشته برمی‌گرداند و نتایج را بر اساس ارتباط درک شده آنها مرتب می‌کند.

پارامترهای اختیاری

توکن جلسه

توکن‌های جلسه، رشته‌های تولید شده توسط کاربر هستند که فراخوانی‌های تکمیل خودکار (جدید) - چه فراخوانی‌های انجام شده از طریق ویجت و چه فراخوانی‌های برنامه‌نویسی - را به عنوان "جلسات" ردیابی می‌کنند. تکمیل خودکار (جدید) از توکن‌های جلسه برای گروه‌بندی مراحل پرس‌وجو و انتخاب یک جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده می‌کند.

شما می‌توانید توکن نشست Places Autocomplete خود را در معرض نمایش قرار دهید تا آن را به سرویس‌های دیگری که بخشی از Places SDK برای iOS نیستند، مانند Address Validation، منتقل کنید:

مکان‌های Swift SDK

let token = AutocompleteSessionToken()
let filter = AutocompleteFilter(origin: CLLocationCoordinate2DMake(39.7, -94.5))
let request = AutocompleteRequest(query: "Piz", sessionToken: token, filter: filter)

PlacesClient.shared.fetchAutocompleteSuggestions(request: request) {
    case .success(let suggestions):
      ...
    case .failure(let placesError):
      print(placesError) 
}

// pass token's string format to use with a service that is not a part of iOS SDK.
print("token: \(token)")

هدف-سی

GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Piz"];
GMSAutocompleteSessionToken *token = [[GMSAutocompleteSessionToken alloc] init];
request.sessionToken = token;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.origin = [[CLLocation alloc] initWithLatitude:39.7 longitude:-94.5];
filter.locationBias = GMSPlaceRectangularLocationOption(topLocation, bottomLocation);

request.filter = filter;
 [[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request
                     callback:^(NSArray<GMSAutocompleteSuggestion *> *_Nullable results,
                                NSError *_Nullable error) {
  ...
}];

// pass token's string format to use with a service that is not a part of iOS SDK.
NSLog(@"%@", token.description);

برای اطلاعات بیشتر به بخش توکن‌های جلسه مراجعه کنید.

پارامترهای اختیاری فیلتر تکمیل خودکار

انواع

یک مکان فقط می‌تواند یک نوع اصلی از انواع جدول A یا جدول B مرتبط با آن داشته باشد. برای مثال، نوع اصلی ممکن است mexican_restaurant یا steak_house باشد.

به طور پیش‌فرض، API صرف نظر از مقدار نوع اصلی مرتبط با مکان، تمام مکان‌ها را بر اساس پارامتر input برمی‌گرداند. با ارسال پارامتر types ، نتایج را به یک نوع اصلی خاص یا انواع اصلی محدود کنید.

از این پارامتر برای مشخص کردن حداکثر پنج مقدار نوع از جدول A یا جدول B استفاده کنید. یک مکان باید با یکی از مقادیر نوع اولیه مشخص شده مطابقت داشته باشد تا در پاسخ گنجانده شود.

درخواست با خطای INVALID_REQUEST رد می‌شود اگر:

بیش از پنج نوع مشخص شده است.
هر نوع ناشناخته‌ای مشخص شده است.

برای مثال، برای محدود کردن نتایج به فروشگاه‌های لوازم ورزشی، آن نوع را در AutocompleteFilter خود مشخص کنید:

مکان‌های Swift SDK

let filter = AutocompleteFilter(types: [ PlaceType(rawValue: "sporting_goods_store") ])

سویفت

let filter = GMSAutocompleteFilter()
filter.types = ["sporting_goods_store"]

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ "sporting_goods_store" ];

کشورها

فقط نتایجی از لیست مناطق مشخص شده را در نظر بگیرید، که به صورت آرایه‌ای با حداکثر ۱۵ مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده‌اند. در صورت حذف، هیچ محدودیتی برای پاسخ اعمال نمی‌شود. به عنوان مثال، برای محدود کردن مناطق به آلمان و فرانسه:

مکان‌های Swift SDK

let filter = AutocompleteFilter(countries: ["DE", "FR"])

سویفت

let filter = GMSAutocompleteFilter()
filter.countries = ["DE", "FR"]

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.countries = @[ @"DE", @"FR" ];

اگر هم locationRestriction و هم countries مشخص کنید، نتایج در ناحیه تقاطع این دو تنظیم قرار می‌گیرند.

ورودی-آفست

آفست کاراکتر یونیکد مبتنی بر صفر که موقعیت مکان‌نما را در input نشان می‌دهد. موقعیت مکان‌نما می‌تواند بر پیش‌بینی‌های برگشتی تأثیر بگذارد. اگر خالی باشد، به طور پیش‌فرض به طول input تنظیم می‌شود.

سوگیری مکانی یا محدودیت مکانی

شما می‌توانید locationBias یا locationRestriction برای تعریف ناحیه جستجو مشخص کنید، اما نه هر دو را. locationRestriction را به عنوان مشخص کننده ناحیه‌ای که نتایج باید درون آن باشند، و locationBias به عنوان مشخص کننده ناحیه‌ای که نتایج باید نزدیک به آن باشند اما می‌توانند خارج از آن ناحیه باشند، در نظر بگیرید.

locationBias یک منطقه برای جستجو را مشخص می‌کند. این مکان به عنوان یک bias عمل می‌کند، به این معنی که نتایج اطراف مکان مشخص شده، از جمله نتایج خارج از منطقه مشخص شده، می‌توانند بازگردانده شوند.
locationRestriction محدوده‌ای را برای جستجو مشخص می‌کند. نتایج خارج از محدوده‌ی مشخص شده بازگردانده نمی‌شوند.

ناحیه locationBias یا locationRestriction را به عنوان یک نمای مستطیلی یا به عنوان یک دایره مشخص کنید.

یک دایره با نقطه مرکزی و شعاع بر حسب متر تعریف می‌شود. شعاع باید بین 0.0 تا 50000.0 باشد، که شامل همه می‌شود. مقدار پیش‌فرض 0.0 است. برای locationRestriction ، باید شعاع را روی مقداری بزرگتر از 0.0 تنظیم کنید. در غیر این صورت، درخواست هیچ نتیجه‌ای برنمی‌گرداند.

برای مثال:

مکان‌های Swift SDK

let center = CLLocationCoordinate2DMake(40.477398, -74.259087)

let bias = CircularCoordinateRegion(center: center, radius: 1000.0)

let filter = AutocompleteFilter(coordinateRegionBias: bias)

سویفت

let center = CLLocationCoordinate2DMake(40.730610, -73.935242)
let radius = 1000.0

filter.locationBias = GMSPlaceCircularLocationOption(center, radius)

هدف-سی

CLLocationCoordinate2D center = CLLocationCoordinate2DMake(40.730610, -73.935242);
radius = 1000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceCircularLocationOption(center, radius);

مستطیل، یک دریچه دید طول و عرض جغرافیایی است که به صورت دو نقطه low و high که به صورت مورب روبروی هم قرار دارند، نمایش داده می‌شود. یک دریچه دید، یک منطقه بسته در نظر گرفته می‌شود، به این معنی که شامل مرز خود نیز می‌شود. محدوده‌های عرض جغرافیایی باید بین ۹۰- تا ۹۰ درجه و محدوده‌های طول جغرافیایی باید بین ۱۸۰- تا ۱۸۰ درجه باشند:

اگر low = high ، نمای دید از آن نقطه واحد تشکیل شده است.
اگر low.longitude > high.longitude ، محدوده طول جغرافیایی معکوس می‌شود (صفحه نمایش از خط طول جغرافیایی ۱۸۰ درجه عبور می‌کند).
اگر low.longitude = -180 درجه و high.longitude = 180 درجه باشد، صفحه نمایش شامل تمام طول‌های جغرافیایی می‌شود.
اگر low.longitude = 180 درجه و high.longitude = -180 درجه باشد، محدوده طول جغرافیایی خالی است.

هر دو low و high باید پر شوند و کادر نمایش داده شده نمی‌تواند خالی باشد. یک viewport خالی منجر به خطا می‌شود.

برای مثال، این نمای کلی، شهر نیویورک را به طور کامل در بر می‌گیرد:

مکان‌های Swift SDK

let northEast = CLLocationCoordinate2DMake(40.477398, -74.259087)
let southWest = CLLocationCoordinate2DMake(40.921628, -73.700051)

let filter = AutocompleteFilter(coordinateRegionBias: bias)

سویفت

let high = CLLocationCoordinate2DMake(40.921628, -73.700051)
let low = CLLocationCoordinate2DMake(40.477398, -74.259087)

let filter = GMSAutocompleteFilter()
filter.locationBias = GMSPlaceRectangularLocationOption(high, low)

هدف-سی

CLLocationCoordinate2D high = CLLocationCoordinate2DMake(40.477398, -74.259087);
CLLocationCoordinate2D low = CLLocationCoordinate2DMake(440.921628, -73.700051);

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceRectangularLocationOption(high, low);

منشأ

نقطه مبدا که از آن فاصله مستقیم تا مقصد محاسبه می‌شود (به صورت distanceMeters برگردانده می‌شود). اگر این مقدار حذف شود، فاصله مستقیم برگردانده نمی‌شود. باید به صورت مختصات عرض و طول جغرافیایی مشخص شود:

مکان‌های Swift SDK

let filter = AutocompleteFilter(origin: CLLocation(latitude: 37.395804, longitude: -122.077023))

سویفت

let filter = GMSAutocompleteFilter()
filter.origin =  CLLocation(latitude: 37.395804, longitude: -122.077023)

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];

filter.origin = [[CLLocation alloc] initWithLatitude:37.395804 longitude: -122.077023];

کد منطقه

کد منطقه‌ای مورد استفاده برای قالب‌بندی پاسخ، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثنائات قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" (.co.uk) است در حالی که کد ISO 3166-1 آن "gb" است (از نظر فنی برای موجودیت "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").

اگر کد منطقه نامعتبری را مشخص کنید، API خطای INVALID_ARGUMENT را برمی‌گرداند. این پارامتر می‌تواند بر اساس قانون مربوطه بر نتایج تأثیر بگذارد.

shouldIncludePureServiceAreaBusinesses

اگر true ، کسب‌وکارهای صرفاً خدماتی را در آرایه پاسخ برمی‌گرداند. یک کسب‌وکار صرفاً خدماتی، کسب‌وکاری است که مستقیماً از مشتریان بازدید می‌کند یا به آنها خدمات ارائه می‌دهد، اما به مشتریان در آدرس کسب‌وکارشان خدمات ارائه نمی‌دهد.

برای مثال:

مکان‌های Swift SDK

let filter = AutocompleteFilter()
filter.shouldIncludePureServiceAreaBusinesses = true

سویفت

let filter = AutocompleteFilter()
filter.shouldIncludePureServiceAreaBusinesses = true

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.shouldIncludePureServiceAreaBusinesses = YES;

برای ارائه راحت‌تر یک تجربه تکمیل خودکار مکان، می‌توانید ویجت تکمیل خودکار مکان را به برنامه خود اضافه کنید. این ویجت یک رابط کاربری اختصاصی و تمام صفحه ارائه می‌دهد که ورودی کاربر را مدیریت می‌کند و پیش‌بینی‌های مکان را به کاربر نمایش می‌دهد و در عین حال اشیاء AutocompletePlaceSuggestion به برنامه برمی‌گرداند. سپس می‌توانید یک درخواست جزئیات مکان (جدید) ارسال کنید تا اطلاعات بیشتری در مورد هر یک از پیش‌بینی‌های مکان دریافت کنید.

همانند زمانی که پیش‌بینی‌های مکان را به صورت برنامه‌نویسی دریافت می‌کنید ، ویجت Place Autocomplete به شما امکان می‌دهد از توکن‌های جلسه برای گروه‌بندی درخواست‌های تکمیل خودکار در جلسه برای اهداف صدور صورتحساب استفاده کنید. می‌توانید با فراخوانی AutocompleteSessionToken() یک توکن جلسه ارسال کنید.

اگر نشانه جلسه (session token) ارائه ندهید، ویجت یک نشانه جلسه تکمیل خودکار (Autocomplete session token) برای شما ایجاد می‌کند که می‌توانید آن را از طریق فراخوانی onSelection دریافت کنید. برای اطلاعات بیشتر در مورد استفاده از نشانه جلسه (session tokens)، به بخش «درباره نشانه جلسه» (About session tokens) مراجعه کنید.

وقتی مقدار show binding روی true تنظیم شود، کاربر به یک نمای تمام صفحه هدایت می‌شود که در آن می‌تواند یک مکان را انتخاب کند. همزمان با تایپ کاربر، ویجت پیشنهادهایی برای مکان‌هایی مانند کسب و کارها، آدرس‌ها و نقاط مورد علاقه برمی‌گرداند. وقتی کاربر مکانی را انتخاب می‌کند، ویجت، هندلر onSelection را با مکان انتخاب شده فراخوانی می‌کند و نمای تمام صفحه را می‌بندد.

پارامترهای ویجت تکمیل خودکار را قرار دهید

علاوه بر پارامترهای موجود در برنامه‌نویسی ، ویجت Place Autocomplete پارامترهای زیر را نیز ارائه می‌دهد.

نشان دادن

show مشخص می‌کند که آیا ویجت نمایش داده شود یا خیر.

انتخاب

تابع closure که هنگام انتخاب یک مکان اجرا می‌شود.

خطای onError

تابع closure هنگام بروز خطا اجرا می‌شود. در صورت بروز خطا، یک PlacesError ارسال می‌شود.

سفارشی‌سازی محتوا و قالب

پارامترهای AutocompleteUICustomization سفارشی‌سازی‌های رابط کاربری را برای اعمال روی ویجت مشخص می‌کنند. گزینه‌های سفارشی‌سازی عبارتند از:

AutocompleteListDensity . این پارامتر به شما امکان می‌دهد چگالی لیست پیشنهادات را، چه به multiLine و چه به twoLine ، انتخاب کنید.
AutocompleteUIIcon . این پارامتر به شما امکان می‌دهد انتخاب کنید که آیا آیکون پیش‌فرض برای هر آیتم لیست نمایش داده شود یا خیر.
theme . این پارامتر یک تم سفارشی را مشخص می‌کند که هر یک از ویژگی‌های پیش‌فرض استایل را لغو می‌کند. می‌توانید رنگ‌ها، تایپوگرافی، فاصله‌گذاری، حاشیه‌ها و گوشه‌های کامپوننت Place Autocomplete خود را سفارشی کنید. پیش‌فرض PlacesMaterialTheme است. هر ویژگی تم که لغو نشده باشد، از استایل‌های پیش‌فرض استفاده می‌کند.

یک مثال کامل از کد را ببینید .

مثال‌های تکمیل خودکار (جدید)

استفاده از locationRestriction و locationBias

تکمیل خودکار (جدید) به طور پیش‌فرض از بایاس IP برای کنترل ناحیه جستجو استفاده می‌کند. با بایاس IP، API از آدرس IP دستگاه برای بایاس کردن نتایج استفاده می‌کند. می‌توانید به صورت اختیاری locationRestriction یا locationBias ، اما نه هر دو، برای مشخص کردن ناحیه‌ای برای جستجو استفاده کنید.

محدودیت مکان، ناحیه مورد جستجو را مشخص می‌کند. نتایج خارج از ناحیه مشخص شده بازگردانده نمی‌شوند. مثال زیر از محدودیت مکان برای محدود کردن درخواست به یک محدودیت مکانی دایره‌ای با شعاع ۵۰۰۰ متر با محوریت سانفرانسیسکو استفاده می‌کند:

مکان‌های Swift SDK

let center = (37.775061, -122.419400)
let radius = 5000.0
let restriction = CircularCoordinateRegion(center: center, radius: radius)
let filter = AutocompleteFilter(coordinateRegionRestriction: restriction)
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

سویفت

let token = GMSAutocompleteSessionToken()

let center = CLLocationCoordinate2DMake(37.775061, -122.419400)
let radius = 5000.0

let filter = GMSAutocompleteFilter()
filter.locationRestriction = GMSPlaceCircularLocationOption(center, radius)

let request = GMSAutocompleteRequest(query:"Piz")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

هدف-سی

CLLocationCoordinate2D center = CLLocationCoordinate2DMake(37.775061, -122.419400);
radius = 5000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationRestriction = GMSPlaceCircularLocationOption(center, radius);
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.
    }
  }
}];

با استفاده از تابع جهت‌گیری مکان، مکان به عنوان یک جهت‌گیری عمل می‌کند، به این معنی که نتایج اطراف مکان مشخص شده، از جمله نتایج خارج از ناحیه مشخص شده، می‌توانند بازگردانده شوند. مثال بعدی درخواست قبلی را برای استفاده از جهت‌گیری مکان تغییر می‌دهد:

مکان‌های Swift SDK

let center = (37.775061, -122.419400)
let radius = 5000.0
let bias = CircularCoordinateRegion(center: center, radius: radius)
let filter = AutocompleteFilter(coordinateRegionBias: bias)
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Sicilian piz", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

سویفت

let token = GMSAutocompleteSessionToken()

let center = CLLocationCoordinate2DMake(37.775061, -122.419400)
let radius = 5000.0

let filter = GMSAutocompleteFilter()
filter.locationBias = GMSPlaceCircularLocationOption(center, radius)

let request = GMSAutocompleteRequest(query:"Piz")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

هدف-سی

CLLocationCoordinate2D center = CLLocationCoordinate2DMake(37.775061, -122.419400);
radius = 5000.0;

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.locationBias = GMSPlaceCircularLocationOption(center, radius);
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.
    }
  }
}];

انواع استفاده

از پارامتر types برای محدود کردن نتایج یک درخواست به نوع خاصی که در جدول A و جدول B ذکر شده است، استفاده کنید. می‌توانید آرایه‌ای تا پنج مقدار را مشخص کنید. در صورت حذف، همه نوع‌ها بازگردانده می‌شوند.

مثال زیر یک رشته پرس‌وجو از نوع "Soccer" را مشخص می‌کند و از پارامتر types برای محدود کردن نتایج به فروشگاه‌هایی از نوع "sporting_goods_store" استفاده می‌کند:

مکان‌های Swift SDK

let filter = AutocompleteFilter(types: [ PlaceType(rawValue: "sporting_goods_store") ])
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Soccer", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

سویفت

let token = GMSAutocompleteSessionToken()

let filter = GMSAutocompleteFilter()
filter.types = ["sporting_goods_store"]

let request = GMSAutocompleteRequest(query:"Soccer")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText))")
        }
      }
    })

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.types = @[ "sporting_goods_store" ];
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Soccer"];
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.
    }
  }
}];

از مبدا استفاده کنید

وقتی پارامتر origin را در درخواست وارد می‌کنید، که به صورت مختصات عرض جغرافیایی و طول جغرافیایی مشخص شده است، API فاصله مستقیم از مبدا تا مقصد را در پاسخ لحاظ می‌کند. پاسخ، فاصله را به صورت distanceMeters برمی‌گرداند.

این مثال مبدا را روی مرکز سانفرانسیسکو تنظیم می‌کند:

مکان‌های Swift SDK

let filter = AutocompleteFilter(origin: CLLocation(latitude: 37.7749, longitude: -122.4194))
let token = AutocompleteSessionToken()

let autocompleteRequest = AutocompleteRequest(query: "Amoeba", sessionToken: token, filter: filter)
switch await placesClient.fetchAutocompleteSuggestions(with: autocompleteRequest) {
case .success(let autocompleteSuggestions):
  for suggestion in autocompleteSuggestions {
    switch suggestion {
    case .place:
      // Show place suggestion data.
    }
  }
case .failure(let placesError):
  // Handle error.
}

سویفت

let token = GMSAutocompleteSessionToken()

let origin = CLLocation(latitude: 37.7749, longitude: -122.4194)

let filter = GMSAutocompleteFilter()

filter.origin =  origin

let request = GMSAutocompleteRequest(query:"Amoeba")
request.filter = filter
request.sessionToken = token

GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { ( results, error ) in
      if let error = error {
        print("Autocomplete error: \(error)")
        return
      }
      if let autocompleteResults = results {
        for result in autocompleteResults {
          print("Result \(String(describing: result.placeSuggestion?.placeID)) with \(String(describing: result.placeSuggestion?.attributedFullText)) and distance: \(String(describing: result.placeSuggestion?.distanceMeters))")
        }
      }
    })

هدف-سی

GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
filter.origin = [[CLLocation alloc] initWithLatitude:37.395804 longitude:-122.077023];
GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Amoeba"];
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.
      }
    }
}];

سفارشی‌سازی محتوا و تم

سویفت

let uiCustomization = AutocompleteUICustomization(
    listDensity: .multiLine,
    listItemIcon: .noIcon,
    theme: PlacesMaterialTheme()
)

افزودن ویجت تکمیل خودکار مکان‌ها (کد کامل)

مکان‌های Swift SDK

struct PlaceAutocompleteDemoView: View {

  @State private var fetchedPlace: Place?
  @State private var placesError: PlacesError?
  @State private var showWidget = false

  public var body: some View {
    VStack {
      Button("Search for a place") {
        showWidget.toggle()
      }
      .placeAutocomplete(
        show: $showWidget,
        onSelection: { (autocompletePlaceSuggestion, autocompleteSessionToken) in
          Task {
            let placesClient = await PlacesClient.shared
            let fetchPlaceRequest = FetchPlaceRequest(
              placeID: autocompletePlaceSuggestion.placeID,
              placeProperties: [.displayName, .formattedAddress],
              sessionToken: autocompleteSessionToken
            )

            switch await placesClient.fetchPlace(with: fetchPlaceRequest) {
            case .success(let place):
              print("Fetched place: \(place)")
              self.fetchedPlace = place
            case .failure(let placesError):
              print("Failed to fetch place: \(placesError)")
              self.placesError = placesError
            }
          }
        },
        onError: { placesError in
          self.placesError = placesError
        }
      )
    }
  }
}

تکمیل خودکار مکان (جدید) با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیش‌بینی‌های مکان را به صورت برنامه‌نویسی‌شده دریافت کنید

تکمیل خودکار درخواست‌ها (جدید)

نسخه SDK سوئیفت را قرار می‌دهد

مکان‌های Swift SDK

سویفت

هدف-سی

پاسخ‌های تکمیل خودکار (جدید)

پارامترهای مورد نیاز

پرس و جو

پارامترهای اختیاری

توکن جلسه

مکان‌های Swift SDK

هدف-سی

پارامترهای اختیاری فیلتر تکمیل خودکار

انواع

مکان‌های Swift SDK

سویفت

هدف-سی

کشورها

مکان‌های Swift SDK

سویفت

هدف-سی

ورودی-آفست

سوگیری مکانی یا محدودیت مکانی

مکان‌های Swift SDK

سویفت

هدف-سی

مکان‌های Swift SDK

سویفت

هدف-سی

منشأ

مکان‌های Swift SDK

سویفت

هدف-سی

کد منطقه

shouldIncludePureServiceAreaBusinesses

مکان‌های Swift SDK

سویفت

هدف-سی

ویجت تکمیل خودکار مکان را اضافه کنید

پارامترهای ویجت تکمیل خودکار را قرار دهید

نشان دادن

انتخاب

خطای onError

سفارشی‌سازی محتوا و قالب

مثال‌های تکمیل خودکار (جدید)

استفاده از locationRestriction و locationBias

مکان‌های Swift SDK

سویفت

هدف-سی

مکان‌های Swift SDK

سویفت

هدف-سی

انواع استفاده

مکان‌های Swift SDK

سویفت

هدف-سی

از مبدا استفاده کنید

مکان‌های Swift SDK

سویفت

هدف-سی

سفارشی‌سازی محتوا و تم

سویفت

افزودن ویجت تکمیل خودکار مکان‌ها (کد کامل)

مکان‌های Swift SDK

تکمیل خودکار مکان (جدید)