کلاس 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 یک شناسه زبان برای زبانی که جزئیات باید به آن بازگردانده شود. |