کلاس 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 | LatLngLiteral optional مکانی که در اطراف آن مکان ها جستجو می شود. |
maxPriceLevel optional | نوع: number optional نتایج را فقط به مکان‌هایی در سطح قیمت مشخص یا پایین‌تر محدود می‌کند. مقادیر معتبر در محدوده 0 (مقرون به صرفه ترین) تا 4 (گران ترین)، شامل می باشد. اگر مشخص شده باشد، باید بزرگتر یا مساوی با minPrice باشد. |
minPriceLevel optional | نوع: number optional نتایج را فقط به مکان‌هایی در سطح قیمت مشخص شده یا بالاتر محدود می‌کند. مقادیر معتبر در محدوده 0 (مقرون به صرفه ترین) تا 4 (گران ترین)، شامل می باشد. اگر مشخص شده باشد باید کمتر یا مساوی maxPrice باشد. |
| نوع: string optional معادل keyword مقادیر در این فیلد با مقادیر فیلد keyword ترکیب شده و به عنوان بخشی از همان رشته جستجو ارسال می شود. |
openNow optional | نوع: boolean optional نتایج را فقط به مکان‌هایی محدود می‌کند که در حال حاضر باز هستند. |
radius optional | نوع: number optional فاصله از مکان داده شده که در آن مکان ها جستجو می شود، بر حسب متر. حداکثر مقدار مجاز 50000 است. |
rankBy optional | نوع: RankBy optional پیش فرض: RankBy.PROMINENCE روش رتبه بندی مورد استفاده در هنگام برگرداندن نتایج را مشخص می کند. توجه داشته باشید که وقتی rankBy روی DISTANCE تنظیم می شود، باید یک location مشخص کنید، اما نمی توانید radius یا bounds تعیین کنید. |
type optional | نوع: string optional مکان هایی از نوع داده شده را جستجو می کند. نوع به زبان محلی محل مورد نظر درخواست ترجمه شده و به عنوان رشته پرس و جو استفاده می شود. اگر یک پرس و جو نیز ارائه شود، به رشته نوع محلی سازی شده الحاق می شود. نتایج یک نوع متفاوت از پاسخ حذف می شوند. از این فیلد برای انجام جستجوهای مقوله ای مستقل از زبان و منطقه استفاده کنید. انواع معتبر در اینجا آورده شده است. |
رابط TextSearchRequest
google.maps.places . TextSearchRequest رابط google.maps.places . TextSearchRequest
یک درخواست جستجوی متنی برای ارسال به PlacesService .
خواص | |
|---|---|
bounds optional | نوع: LatLngBounds | LatLngBoundsLiteral optional کران‌ها برای سوگیری نتایج هنگام جستجوی مکان‌ها (اختیاری) استفاده می‌شوند. در صورت تنظیم bounds location و radius هر دو نادیده گرفته می شوند. نتایج به کسانی که در این محدوده هستند محدود نخواهد شد. اما، نتایج داخل آن رتبه بالاتری خواهد داشت. |
language optional | نوع: string optional شناسه زبان برای زبانی که در صورت امکان نام و آدرس باید به آن بازگردانده شود. لیست زبان های پشتیبانی شده را ببینید. |
location optional | نوع: LatLng | LatLngLiteral optional مرکز منطقه هنگام جستجوی مکان‌ها، نتایج را سوگیری می‌کرد. |
query optional | نوع: string optional مدت درخواست درخواست به عنوان مثال، نام یک مکان ("برج ایفل")، یک دسته که با نام یک مکان ("پیتزا در نیویورک")، یا نام یک مکان به دنبال ابهام‌زدایی مکان ("استارباکس در سیدنی"). |
radius optional | نوع: number optional شعاع ناحیه مورد استفاده برای سوگیری هنگام جستجوی مکان‌ها، بر حسب متر است. |
region optional | نوع: string optional یک کد منطقه ای برای سوگیری به سمت نتیجه می شود. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). |
type optional | نوع: string optional مکان هایی از نوع داده شده را جستجو می کند. نوع به زبان محلی محل مورد نظر درخواست ترجمه شده و به عنوان رشته پرس و جو استفاده می شود. اگر یک پرس و جو نیز ارائه شود، به رشته نوع محلی سازی شده الحاق می شود. نتایج یک نوع متفاوت از پاسخ حذف می شوند. از این فیلد برای انجام جستجوهای مقوله ای مستقل از زبان و منطقه استفاده کنید. انواع معتبر در اینجا آورده شده است. |
ثابت های RankBy
google.maps.places . RankBy ثابت های google.maps.places . RankBy
گزینه های رتبه بندی برای درخواست PlaceSearch.
با فراخوانی const {RankBy} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
|---|---|
DISTANCE | نتایج مکان را بر اساس فاصله از مکان رتبه بندی می کند. |
PROMINENCE | رتبه ها نتایج را بر اساس برجستگی خود قرار می دهند. |
LocationBias typedef
google.maps.places . LocationBias typedef
LocationBias یک مرز نرم یا اشاره ای را برای استفاده در هنگام جستجوی مکان ها نشان می دهد. نتایج ممکن است از خارج از منطقه مشخص شده باشد. برای استفاده از آدرس IP کاربر فعلی به عنوان یک بایاس، رشته "IP_BIAS" را می توان مشخص کرد. توجه: در صورت استفاده از Circle ، مرکز و شعاع باید تعریف شود.
LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral | LatLngBounds |