کلاس PlacesService
google.maps.places . PlacesService کلاس google.maps.places . PlacesService
شامل روش های مربوط به جستجوی مکان ها و بازیابی جزئیات یک مکان است.
با فراخوانی const {PlacesService} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
سازنده | |
|---|---|
PlacesService | PlacesService(attrContainer) پارامترها:
یک نمونه جدید از PlacesService ایجاد می کند که اسناد را در ظرف مشخص شده ارائه می کند. |
روش ها | |
|---|---|
findPlaceFromPhoneNumber | findPlaceFromPhoneNumber(request, callback) پارامترها:
ارزش بازگشتی: ندارد لیستی از مکان ها را بر اساس شماره تلفن بازیابی می کند. در بیشتر موارد باید فقط یک مورد در لیست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد ممکن است بیش از یک نتیجه برگردانده شود. PlaceResult های ارسال شده به callback زیر مجموعه های یک PlaceResult کامل هستند. برنامه شما می تواند با تماس با PlacesService.getDetails و ارسال PlaceResult.place_id برای مکان مورد نظر، PlaceResult دقیق تری برای هر مکان دریافت کند. |
findPlaceFromQuery | findPlaceFromQuery(request, callback) پارامترها:
ارزش بازگشتی: ندارد فهرستی از مکان ها را بر اساس یک رشته پرس و جو بازیابی می کند. در بیشتر موارد باید فقط یک مورد در لیست نتایج وجود داشته باشد، اما اگر درخواست مبهم باشد ممکن است بیش از یک نتیجه برگردانده شود. PlaceResult های ارسال شده به callback زیر مجموعه های یک PlaceResult کامل هستند. برنامه شما می تواند با تماس با PlacesService.getDetails و ارسال PlaceResult.place_id برای مکان مورد نظر، PlaceResult دقیق تری برای هر مکان دریافت کند. |
getDetails | getDetails(request, callback) پارامترها:
ارزش بازگشتی: ندارد جزئیات مربوط به مکان شناسایی شده توسط placeId داده شده را بازیابی می کند. |
nearbySearch | nearbySearch(request, callback) پارامترها:
ارزش بازگشتی: ندارد فهرستی از مکان های نزدیک به یک مکان خاص را بر اساس کلمه کلیدی یا نوع بازیابی می کند. مکان باید همیشه مشخص شود، یا با عبور از LatLngBounds ، یا پارامترهای location و radius . PlaceResult های ارسال شده به callback زیرمجموعه های PlaceResult کامل هستند. برنامه شما می‌تواند با ارسال یک درخواست Place Details با ارسال PlaceResult.place_id برای مکان مورد نظر، PlaceResult دقیق‌تری برای هر مکان دریافت کند. شی PlaceSearchPagination می تواند برای واکشی صفحات اضافی از نتایج استفاده شود (اگر این آخرین صفحه نتایج باشد یا اگر فقط یک صفحه از نتایج وجود داشته باشد، تهی است). |
textSearch | textSearch(request, callback) پارامترها:
ارزش بازگشتی: ندارد فهرستی از مکان‌ها را بر اساس یک رشته جستجو بازیابی می‌کند (به عنوان مثال، "پیتزا در نیویورک"، یا "فروشگاه‌های کفش در نزدیکی اتاوا"). پارامترهای مکان اختیاری هستند. هنگامی که مکان مشخص می شود، نتایج به جای محدود شدن به مکان های داخل منطقه، فقط نسبت به نتایج نزدیک تعصب دارند. هنگامی که می خواهید مکان ها را با استفاده از یک رشته دلخواه جستجو کنید و در مواردی که ممکن است نخواهید نتایج جستجو را به یک مکان خاص محدود کنید، از textSearch استفاده کنید. شی PlaceSearchPagination می تواند برای واکشی صفحات اضافی از نتایج استفاده شود (اگر این آخرین صفحه نتایج باشد یا اگر فقط یک صفحه از نتایج وجود داشته باشد، تهی است). |
رابط PlaceDetailsRequest
google.maps.places . PlaceDetailsRequest رابط google.maps.places . PlaceDetailsRequest
درخواست جزئیات مکان برای ارسال به PlacesService .
خواص | |
|---|---|
placeId | نوع: string شناسه مکانی مکانی که جزئیات آن درخواست شده است. |
fields optional | نوع: Array <string> optional فیلدهایی که باید در پاسخ جزئیات گنجانده شوند، که برای آن صورتحساب می‌شود . اگر هیچ فیلدی مشخص نشده باشد یا ['ALL'] وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آن صورتحساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها PlaceResult ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه مشخص کرد (به عنوان مثال، "geometry.location" ). |
language optional | نوع: string optional یک شناسه زبان برای زبانی که جزئیات باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید. |
region optional | نوع: string optional کد منطقه ای منطقه کاربر. این می‌تواند بر عکس‌هایی که ممکن است بازگردانده شوند و احتمالاً موارد دیگر تأثیر بگذارد. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). |
sessionToken optional | نوع: AutocompleteSessionToken optional مرجع منحصر به فرد مورد استفاده برای بسته بندی درخواست جزئیات با یک جلسه تکمیل خودکار. |
رابط FindPlaceFromPhoneNumberRequest
google.maps.places . FindPlaceFromPhoneNumberRequest رابط google.maps.places . FindPlaceFromPhoneNumberRequest
مکان یافتن از درخواست جستجوی متنی برای ارسال به PlacesService.findPlaceFromPhoneNumber .
خواص | |
|---|---|
fields | نوع: Array <string> فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورتحساب دریافت می‌شود . اگر ['ALL'] وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورتحساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها PlaceResult ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه مشخص کرد (به عنوان مثال، "geometry.location" ). |
phoneNumber | نوع: string شماره تلفن محل جستجو فرمت باید E.164 باشد. |
language optional | نوع: string optional شناسه زبان برای زبانی که در صورت امکان نام و آدرس باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید. |
locationBias optional | نوع: LocationBias optional سوگیری استفاده شده هنگام جستجوی مکان. نتیجه نسبت به LocationBias داده شده تعصب دارد، اما محدود به آن نیست. |
رابط FindPlaceFromQueryRequest
google.maps.places . FindPlaceFromQueryRequest رابط google.maps.places . FindPlaceFromQueryRequest
مکان یافتن از درخواست جستجوی متن برای ارسال به PlacesService.findPlaceFromQuery .
خواص | |
|---|---|
fields | نوع: Array <string> فیلدهایی که باید در پاسخ گنجانده شوند، که برای آن صورتحساب دریافت می‌شود . اگر ['ALL'] وارد شود، همه فیلدهای موجود برگردانده می‌شوند و برای آنها صورتحساب دریافت می‌شود (این برای استقرار تولید توصیه نمی‌شود). برای فهرستی از فیلدها PlaceResult ببینید. فیلدهای تودرتو را می توان با مسیرهای نقطه مشخص کرد (به عنوان مثال، "geometry.location" ). |
query | نوع: string پرس و جو درخواست به عنوان مثال، نام یا آدرس یک مکان. |
language optional | نوع: string optional شناسه زبان برای زبانی که در صورت امکان نام و آدرس باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید. |
locationBias optional | نوع: LocationBias optional سوگیری استفاده شده هنگام جستجوی مکان. نتیجه نسبت به LocationBias داده شده تعصب دارد، اما محدود به آن نیست. |
رابط PlaceSearchRequest
google.maps.places . PlaceSearchRequest رابط google.maps.places . PlaceSearchRequest
یک عبارت جستجوی مکان برای ارسال به PlacesService .
خواص | |
|---|---|
bounds optional | نوع: LatLngBounds | LatLngBoundsLiteral optional محدوده هایی که در آن مکان ها جستجو می شود. در صورت تنظیم bounds location و radius هر دو نادیده گرفته می شوند. |
keyword optional | نوع: string optional اصطلاحی که باید با تمام فیلدهای موجود، از جمله نام، نوع و آدرس، و همچنین نظرات مشتریان و سایر محتوای شخص ثالث مطابقت داشته باشد. |
language optional | نوع: string optional شناسه زبان برای زبانی که در صورت امکان نام و آدرس باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید. |
location optional | نوع: LatLng | |