کلاس 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 باشد. |
name optional name optional | نوع: 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 | LatLngBounds | LatLngBoundsLiteral | Circle | CircleLiteral |string
LocationRestriction typedef
google.maps.places . LocationRestriction
typedef
LocationRestriction یک مرز دقیق برای استفاده در هنگام جستجوی Places را نشان می دهد.
ثابت های PlacesServiceStatus
google.maps.places . PlacesServiceStatus
ثابت های google.maps.places . PlacesServiceStatus
وضعیتی که توسط PlacesService
پس از تکمیل جستجوهایش بازگردانده شد. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK'
یا google.maps.places.PlacesServiceStatus.OK
.
با فراخوانی const {PlacesServiceStatus} = await google.maps.importLibrary("places")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
INVALID_REQUEST | این درخواست نامعتبر بود. |
NOT_FOUND | مکان مورد اشاره یافت نشد. |
OK | پاسخ حاوی یک نتیجه معتبر است. |
OVER_QUERY_LIMIT | برنامه از سهمیه درخواست خود عبور کرده است. |
REQUEST_DENIED | برنامه مجاز به استفاده از PlacesService نیست. |
UNKNOWN_ERROR | درخواست PlacesService به دلیل خطای سرور قابل پردازش نیست. اگر دوباره تلاش کنید ممکن است درخواست با موفقیت انجام شود. |
ZERO_RESULTS | هیچ نتیجه ای برای این درخواست یافت نشد. |
رابط PlaceSearchPagination
google.maps.places . PlaceSearchPagination
رابط google.maps.places . PlaceSearchPagination
شیء مورد استفاده برای واکشی صفحات اضافی از نتایج Places.
خواص | |
---|---|
hasNextPage | نوع: boolean نشان می دهد که آیا نتایج بیشتر در دسترس است. true زمانی که یک صفحه نتایج اضافی وجود دارد. |
مواد و روش ها | |
---|---|
nextPage | nextPage() پارامترها: ندارد ارزش بازگشتی: ندارد صفحه بعدی نتایج را واکشی می کند. از همان عملکرد برگشت به تماس استفاده می کند که برای اولین درخواست جستجو ارائه شده است. |
رابط PlaceResult
google.maps.places . PlaceResult
رابط google.maps.places . PlaceResult
اطلاعات مربوط به یک مکان را تعریف می کند.
خواص | |
---|---|
address_components optional | نوع: Array < GeocoderAddressComponent > optional مجموعه اجزای آدرس برای مکان این مکان. فقط با PlacesService.getDetails موجود است. |
adr_address optional | نوع: string optional نمایش آدرس مکان در میکروفرمت adr . فقط با PlacesService.getDetails موجود است. |
aspects optional | نوع: Array < PlaceAspectRating > optional جنبههای رتبهبندی شده این مکان، بر اساس نظرات کاربران Google و Zagat. رتبه بندی در مقیاس 0 تا 30 است. |
business_status optional | نوع: BusinessStatus optional پرچمی که وضعیت عملیاتی مکان را نشان میدهد، اگر یک تجارت باشد (نشان میدهد که آیا مکان عملیاتی است یا به طور موقت یا دائم بسته است). اگر هیچ داده ای در دسترس نباشد، پرچم در پاسخ های جستجو یا جزئیات وجود ندارد. |
formatted_address optional | نوع: string optional آدرس کامل مکان |
formatted_phone_number optional | نوع: string optional شماره تلفن مکان، که بر اساس کنوانسیون منطقهای شماره قالببندی شده است. فقط با PlacesService.getDetails موجود است. |
geometry optional | نوع: PlaceGeometry optional اطلاعات مربوط به هندسه مکان. |
html_attributions optional | نوع: Array <string> optional متن انتساب برای این نتیجه مکان نمایش داده شود. html_attributions موجود همیشه صرف نظر از اینکه چه fields درخواست شده است، بازگردانده می شوند و باید نمایش داده شوند. |
icon optional | نوع: string optional نشانی وب منبع تصویری که می تواند برای نشان دادن دسته این مکان استفاده شود. |
icon_background_color optional | نوع: string optional رنگ پس زمینه برای استفاده با نماد مکان. همچنین به PlaceResult.icon_mask_base_uri مراجعه کنید. |
icon_mask_base_uri optional | نوع: string optional یک URL کوتاه شده به یک ماسک نماد. با افزودن پسوند فایل به انتها (به عنوان مثال .svg یا .png ) به انواع نمادهای مختلف دسترسی پیدا کنید. |
international_phone_number optional | نوع: string optional شماره تلفن مکان در قالب بین المللی. قالب بین المللی شامل کد کشور است و با علامت مثبت (+) پیشوند است. فقط با PlacesService.getDetails موجود است. |
name optional | نوع: string optional نام مکان توجه: در مورد مکان های وارد شده توسط کاربر، این متن خام است که توسط کاربر تایپ شده است. لطفاً هنگام استفاده از این داده ها احتیاط کنید، زیرا کاربران مخرب ممکن است سعی کنند از آن به عنوان بردار حملات تزریق کد استفاده کنند (به http://en.wikipedia.org/wiki/Code_injection مراجعه کنید). |
opening_hours optional | نوع: PlaceOpeningHours optional زمان باز یا بسته شدن مکان را مشخص می کند. |
permanently_closed optional permanently_closed optional | نوع: boolean optional پرچمی که نشان می دهد مکان، به طور دائم یا موقت بسته است. اگر مکان عملیاتی باشد، یا اگر داده ای در دسترس نباشد، پرچم در پاسخ وجود ندارد. |
photos optional | نوع: Array < PlacePhoto > optional عکس های این مکان این مجموعه دارای حداکثر ده شیء PlacePhoto خواهد بود. |
place_id optional | نوع: string optional یک شناسه منحصر به فرد برای مکان. |
plus_code optional | نوع: PlacePlusCode optional کدهای مکان باز یا " کدهای پلاس " را برای مکان تعریف می کند. |
price_level optional | نوع: number optional سطح قیمت مکان، در مقیاس 0 تا 4. سطوح قیمت به صورت زیر تفسیر می شود:
|
rating optional | نوع: number optional امتیازی بین 1.0 تا 5.0 بر اساس نظرات کاربران از این مکان. |
reviews optional | نوع: Array < PlaceReview > optional فهرستی از نظرات درباره این مکان. فقط با PlacesService.getDetails موجود است. |
types optional | نوع: Array <string> optional آرایهای از انواع برای این مکان (برای مثال، ["political", "locality"] یا ["restaurant", "establishment"] ). |
url optional | نوع: string optional URL صفحه رسمی گوگل برای این مکان. این صفحه متعلق به Google است که حاوی بهترین اطلاعات موجود در مورد مکان است. فقط با PlacesService.getDetails موجود است. |
user_ratings_total optional | نوع: number optional تعداد رتبهبندیهای کاربرانی که در PlaceResult.rating این مکان مشارکت داشتهاند. |
utc_offset optional utc_offset optional | نوع: number optional انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، سیدنی، استرالیا در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین utc_offset 660 خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، utc_offset برای کیپ ورد -60 است. فقط با PlacesService.getDetails موجود است. |
utc_offset_minutes optional | نوع: number optional انحراف از UTC منطقه زمانی فعلی Place، در دقیقه. به عنوان مثال، سیدنی، استرالیا در صرفه جویی در روز 11 ساعت جلوتر از UTC است، بنابراین utc_offset_minutes 660 خواهد بود. برای مناطق زمانی پشت UTC، افست منفی است. به عنوان مثال، utc_offset_minutes برای کیپ ورد -60 است. فقط با PlacesService.getDetails موجود است. |
vicinity optional | نوع: string optional آدرس ساده شده مکان، شامل نام خیابان، شماره خیابان، و محل، اما نه استان/ایالت، کد پستی یا کشور. به عنوان مثال، دفتر Google در سیدنی، استرالیا دارای ارزش مجاورت "48 Pirrama Road, Pyrmont" است. فقط با PlacesService.getDetails موجود است. |
website optional | نوع: string optional وب سایت معتبر برای این مکان، مانند صفحه اصلی یک کسب و کار. فقط با PlacesService.getDetails موجود است. |
رابط PlaceAspectRating
google.maps.places . PlaceAspectRating
رابط google.maps.places . PlaceAspectRating
اطلاعات مربوط به جنبه ای از مکانی را که کاربران بررسی کرده اند تعریف می کند.
خواص | |
---|---|
rating | نوع: number رتبه بندی این جنبه. برای نظرات فردی، این یک عدد صحیح از 0 تا 3 است. برای رتبهبندیهای انبوه یک مکان، این یک عدد صحیح از 0 تا 30 است. |
type | نوع: string نوع جنبه برای مثال، "food" ، "decor" ، "service" یا "overall" . |
ثابت های وضعیت کسب و کار
google.maps.places . BusinessStatus
ثابت های google.maps.places . BusinessStatus
وضعیت عملیاتی مکان، اگر یک کسب و کار باشد، در یک PlaceResult برگردانده شده است (نشان می دهد که آیا مکان عملیاتی است یا به طور موقت یا دائم بسته است). اینها را با مقدار یا نام ثابت مشخص کنید (مثال: 'OPERATIONAL'
یا google.maps.places.BusinessStatus.OPERATIONAL
).
با فراخوانی const {BusinessStatus} = await google.maps.importLibrary("places")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
CLOSED_PERMANENTLY | کسب و کار برای همیشه تعطیل است. |
CLOSED_TEMPORARILY | کسب و کار به طور موقت تعطیل است. |
OPERATIONAL | کسب و کار به طور معمول کار می کند. |
رابط مکان هندسه
google.maps.places . PlaceGeometry
رابط google.maps.places . PlaceGeometry
اطلاعات مربوط به هندسه یک مکان را تعریف می کند.
خواص | |
---|---|
location optional | نوع: LatLng optional موقعیت مکان |
viewport optional | نوع: LatLngBounds optional نمای ترجیحی هنگام نمایش این مکان بر روی نقشه. اگر نمای ترجیحی برای Place مشخص نباشد، این ویژگی null خواهد بود. فقط با PlacesService.getDetails موجود است. |
رابط PlaceOpeningHours
google.maps.places . PlaceOpeningHours
رابط google.maps.places . PlaceOpeningHours
اطلاعات مربوط به ساعات کاری یک مکان را تعریف می کند.
خواص | |
---|---|
open_now optional open_now optional | نوع: boolean optional اینکه آیا مکان در زمان فعلی باز است یا خیر. |
periods optional | نوع: Array < PlaceOpeningHoursPeriod > optional دوره های افتتاحیه برای هر روز هفته، از یکشنبه، به ترتیب زمانی شروع می شود. روزهایی که مکان باز نیست شامل نمی شود. فقط با PlacesService.getDetails موجود است. |
weekday_text optional | نوع: Array <string> optional آرایهای از هفت رشته که ساعات کار قالببندی شده را برای هر روز هفته نشان میدهد. سرویس مکانها ساعتهای کاری را بهطور مناسب برای زبان فعلی قالببندی و بومیسازی میکند. ترتیب عناصر در این آرایه به زبان بستگی دارد. برخی از زبان ها هفته را از دوشنبه شروع می کنند در حالی که برخی دیگر از یکشنبه شروع می شوند. فقط با PlacesService.getDetails موجود است. تماس های دیگر ممکن است یک آرایه خالی را برگردانند. |
مواد و روش ها | |
---|---|
isOpen | isOpen([date]) مولفه های:
مقدار بازگشتی: boolean|undefined بررسی کنید که آیا مکان در حال حاضر باز است (زمانی که تاریخ سپری نشده است)، یا در تاریخ معین. اگر این مکان PlaceResult.utc_offset_minutes یا PlaceOpeningHours.periods نداشته باشد، undefined برگردانده می شود ( PlaceOpeningHours.periods فقط از طریق PlacesService.getDetails در دسترس است). این روش ساعات استثنایی مانند ساعات تعطیلات را در نظر نمی گیرد. |
رابط PlaceOpeningHoursPeriod
google.maps.places . PlaceOpeningHoursPeriod
رابط google.maps.places . PlaceOpeningHoursPeriod
اطلاعات ساختاریافته در مورد ساعات کاری یک مکان را تعریف می کند. توجه: اگر یک مکان همیشه باز باشد، بخش close
در پاسخ وجود ندارد. مشتریان میتوانند به نمایش همیشه باز بودن بهعنوان یک دوره open
حاوی day
با مقدار 0
و time
با مقدار "0000"
و بدون close
اعتماد کنند.
خواص | |
---|---|
open | زمان افتتاحیه برای مکان. |
close optional | نوع: PlaceOpeningHoursTime optional زمان بسته شدن مکان. |
رابط PlaceOpeningHoursTime
google.maps.places . PlaceOpeningHoursTime
رابط google.maps.places . PlaceOpeningHoursTime
زمان باز یا بسته شدن یک مکان را مشخص می کند.
خواص | |
---|---|
day | نوع: number روزهای هفته، به عنوان یک عدد در محدوده [ 0 ، 6 ]، از یکشنبه شروع می شود. مثلا 2 یعنی سه شنبه. |
hours | نوع: number ساعات PlaceOpeningHoursTime.time به عنوان یک عدد، در محدوده [ 0 ، 23 ]. این در منطقه زمانی Place گزارش خواهد شد. |
minutes | نوع: number دقیقه PlaceOpeningHoursTime.time به عنوان یک عدد، در محدوده [ 0 ، 59 ]. این در منطقه زمانی Place گزارش خواهد شد. |
time | نوع: string ساعت شبانه روز با فرمت 24 ساعته "هوم". مقادیر در محدوده [ "0000" , "2359" ] هستند. زمان در منطقه زمانی مکان گزارش خواهد شد. |
nextDate optional | نوع: number optional مهر زمانی (به عنوان میلی ثانیه از زمان، مناسب برای استفاده با new Date() ) که نشان دهنده وقوع بعدی این PlaceOpeningHoursTime است. از PlaceOpeningHoursTime.day هفته، PlaceOpeningHoursTime.time و PlaceResult.utc_offset_minutes محاسبه میشود. اگر PlaceResult.utc_offset_minutes undefined باشد، nextDate undefined است. |
رابط PlacePlusCode
google.maps.places . PlacePlusCode
رابط google.maps.places . PlacePlusCode
کدهای مکان باز یا " کدهای پلاس " را برای یک مکان تعریف می کند. کدهای پلاس می توانند به عنوان جایگزینی برای آدرس های خیابان ها در مکان هایی که وجود ندارند (جایی که ساختمان ها شماره گذاری نشده اند یا خیابان ها نامگذاری نشده اند) استفاده شود.
خواص | |
---|---|
global_code | نوع: string یک کد مثبت با 1/8000 درجه در 1/8000 درجه منطقه. به عنوان مثال، "8FVC9G8F+5W" . |
compound_code optional | نوع: string optional یک کد مثبت با 1/8000 درجه در 1/8000 درجه یک منطقه که در آن چهار نویسه اول (کد منطقه) حذف شده و با یک توضیح محل جایگزین می شود. به عنوان مثال، "9G8F+5W Zurich, Switzerland" . اگر مکان مناسبی برای کوتاه کردن کد پیدا نشود، این قسمت حذف می شود. |
رابط PlacePhoto
google.maps.places . PlacePhoto
رابط google.maps.places . PlacePhoto
یک عنصر عکس از یک مکان را نشان می دهد.
خواص | |
---|---|
height | نوع: number ارتفاع عکس بر حسب پیکسل |
html_attributions | نوع: Array <string> متن ذکر منبع برای این عکس نمایش داده شود. |
width | نوع: number عرض عکس بر حسب پیکسل |
مواد و روش ها | |
---|---|
getUrl | getUrl([opts]) مولفه های:
مقدار بازگشتی: string URL تصویر مربوط به گزینه های مشخص شده را برمی گرداند. |
رابط PhotoOptions
google.maps.places . PhotoOptions
رابط google.maps.places . PhotoOptions
گزینه های درخواست عکس را تعریف می کند.
خواص | |
---|---|
maxHeight optional | نوع: number optional حداکثر ارتفاع بر حسب پیکسل تصویر برگشتی. |
maxWidth optional | نوع: number optional حداکثر عرض بر حسب پیکسل تصویر برگشتی. |
رابط PlaceReview
google.maps.places . PlaceReview
رابط google.maps.places . PlaceReview
نشان دهنده یک بررسی واحد از یک مکان است.
خواص | |
---|---|
author_name | نوع: string نام داور. |
language | نوع: string یک کد زبان IETF که نشان دهنده زبانی است که این بررسی به آن نوشته شده است. توجه داشته باشید که این کد فقط شامل برچسب زبان اصلی بدون هیچ برچسب ثانویه ای است که کشور یا منطقه را نشان می دهد. به عنوان مثال، تمام نظرات انگلیسی به جای « 'en' -AU» یا «en-UK» با عنوان 'en' برچسب گذاری شده اند. |
profile_photo_url | نوع: string نشانی اینترنتی تصویر نمایه بازبین. |
relative_time_description | نوع: string رشته ای از زمان اخیر قالب بندی شده، که زمان بررسی را نسبت به زمان کنونی به شکلی مناسب برای زبان و کشور بیان می کند. به عنوان مثال "a month ago" . |
text | نوع: string متن یک بررسی. |
time | نوع: number مهر زمانی برای بازبینی، بیان شده در ثانیه از زمان. |
aspects optional aspects optional | نوع: Array < PlaceAspectRating > optional جنبه های رتبه بندی شده توسط بررسی. رتبه بندی در مقیاس 0 تا 3. |
author_url optional | نوع: string optional URL به نمایه بازبین. وقتی نمایه بازبین در دسترس نباشد، این مورد undefined است. |
rating optional | نوع: number optional امتیاز این بررسی، عددی بین 1.0 تا 5.0 (شامل). |
کلاس 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 باشد. |
name optional name optional | نوع: 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
A text search request to be sent to the PlacesService
.
خواص | |
---|---|
bounds optional | نوع: LatLngBounds | LatLngBoundsLiteral optional Bounds used to bias results when searching for Places (optional). Both location and radius will be ignored if bounds is set. Results will not be restricted to those inside these bounds; but, results inside it will rank higher. |
language optional | نوع: string optional A language identifier for the language in which names and addresses should be returned, when possible. See the list of supported languages . |
location optional | نوع: LatLng | LatLngLiteral optional The center of the area used to bias results when searching for Places. |
query optional | نوع: string optional The request's query term. For example, the name of a place ('Eiffel Tower'), a category followed by the name of a location ('pizza in New York'), or the name of a place followed by a location disambiguator ('Starbucks in Sydney'). |
radius optional | نوع: number optional The radius of the area used to bias results when searching for Places, in meters. |
region optional | نوع: string optional A region code to bias results towards. The region code accepts a ccTLD ("top-level domain") two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" ( .co.uk ) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland"). |
type optional | نوع: string optional Searches for places of the given type. The type is translated to the local language of the request's target location and used as a query string. If a query is also provided, it is concatenated to the localized type string. Results of a different type are dropped from the response. Use this field to perform language and region independent categorical searches. Valid types are given here . |
RankBy constants
google.maps.places . RankBy
constants
Ranking options for a PlaceSearchRequest.
Access by calling const {RankBy} = await google.maps.importLibrary("places")
. کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
DISTANCE | Ranks place results by distance from the location. |
PROMINENCE | Ranks place results by their prominence. |
LocationBias typedef
google.maps.places . LocationBias
typedef
A LocationBias represents a soft boundary or hint to use when searching for Places. Results may come from outside the specified area. To use the current user's IP address as a bias, the string "IP_BIAS"
can be specified. Note: if using a Circle
the center and radius must be defined.
LatLng | LatLngLiteral | LatLngBounds | LatLngBoundsLiteral | Circle | CircleLiteral |string
LocationRestriction typedef
google.maps.places . LocationRestriction
typedef
A LocationRestriction represents a strict boundary to use when searching for Places.
PlacesServiceStatus constants
google.maps.places . PlacesServiceStatus
constants
The status returned by the PlacesService
on the completion of its searches. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. For example, 'OK'
or google.maps.places.PlacesServiceStatus.OK
.
Access by calling const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
INVALID_REQUEST | This request was invalid. |
NOT_FOUND | The place referenced was not found. |
OK | The response contains a valid result. |
OVER_QUERY_LIMIT | The application has gone over its request quota. |
REQUEST_DENIED | The application is not allowed to use the PlacesService . |
UNKNOWN_ERROR | The PlacesService request could not be processed due to a server error. The request may succeed if you try again. |
ZERO_RESULTS | No result was found for this request. |
PlaceSearchPagination interface
google.maps.places . PlaceSearchPagination
interface
An object used to fetch additional pages of Places results.
خواص | |
---|---|
hasNextPage | Type: boolean Indicates if further results are available. true when there is an additional results page. |
مواد و روش ها | |
---|---|
nextPage | nextPage() پارامترها: ندارد ارزش بازگشتی: ندارد Fetches the next page of results. Uses the same callback function that was provided to the first search request. |
PlaceResult interface
google.maps.places . PlaceResult
interface
Defines information about a Place.
خواص | |
---|---|
address_components optional | Type: Array < GeocoderAddressComponent > optional The collection of address components for this Place's location. Only available with PlacesService.getDetails . |
adr_address optional | نوع: string optional The representation of the Place's address in the adr microformat . Only available with PlacesService.getDetails . |
aspects optional | Type: Array < PlaceAspectRating > optional The rated aspects of this Place, based on Google and Zagat user reviews. The ratings are on a scale of 0 to 30. |
business_status optional | Type: BusinessStatus optional A flag indicating the operational status of the Place, if it is a business (indicates whether the place is operational, or closed either temporarily or permanently). If no data is available, the flag is not present in search or details responses. |
formatted_address optional | نوع: string optional The Place's full address. |
formatted_phone_number optional | نوع: string optional The Place's phone number, formatted according to the number's regional convention . Only available with PlacesService.getDetails . |
geometry optional | Type: PlaceGeometry optional The Place's geometry-related information. |
html_attributions optional | Type: Array <string> optional Attribution text to be displayed for this Place result. Available html_attributions are always returned regardless of what fields have been requested, and must be displayed. |
icon optional | نوع: string optional URL to an image resource that can be used to represent this Place's category. |
icon_background_color optional | نوع: string optional Background color for use with a Place's icon. See also PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional | نوع: string optional A truncated URL to an icon mask. Access different icon types by appending a file extension to the end (ie .svg or .png ). |
international_phone_number optional | نوع: string optional The Place's phone number in international format. International format includes the country code, and is prefixed with the plus (+) sign. Only available with PlacesService.getDetails . |
name optional | نوع: string optional The Place's name. Note: In the case of user entered Places, this is the raw text, as typed by the user. Please exercise caution when using this data, as malicious users may try to use it as a vector for code injection attacks (See http://en.wikipedia.org/wiki/Code_injection ). |
opening_hours optional | Type: PlaceOpeningHours optional Defines when the Place opens or closes. |
permanently_closed optional permanently_closed optional | نوع: boolean optional A flag indicating whether the Place is closed, either permanently or temporarily. If the place is operational, or if no data is available, the flag is absent from the response. |
photos optional | Type: Array < PlacePhoto > optional Photos of this Place. The collection will contain up to ten PlacePhoto objects. |
place_id optional | نوع: string optional A unique identifier for the Place. |
plus_code optional | Type: PlacePlusCode optional Defines Open Location Codes or " plus codes " for the Place. |
price_level optional | نوع: number optional The price level of the Place, on a scale of 0 to 4. Price levels are interpreted as follows:
|
rating optional | نوع: number optional A rating, between 1.0 to 5.0, based on user reviews of this Place. |
reviews optional | Type: Array < PlaceReview > optional A list of reviews of this Place. Only available with PlacesService.getDetails . |
types optional | Type: Array <string> optional An array of types for this Place (for example, ["political", "locality"] or ["restaurant", "establishment"] ). |
url optional | نوع: string optional URL of the official Google page for this place. This is the Google-owned page that contains the best available information about the Place. Only available with PlacesService.getDetails . |
user_ratings_total optional | نوع: number optional The number of user ratings which contributed to this Place's PlaceResult.rating . |
utc_offset optional utc_offset optional | نوع: number optional The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset is -60 for Cape Verde. Only available with PlacesService.getDetails . |
utc_offset_minutes optional | نوع: number optional The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset_minutes will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset_minutes is -60 for Cape Verde. Only available with PlacesService.getDetails . |
vicinity optional | نوع: string optional The simplified address for the Place, including the street name, street number, and locality, but not the province/state, postal code, or country. For example, Google's Sydney, Australia office has a vicinity value of "48 Pirrama Road, Pyrmont" . Only available with PlacesService.getDetails . |
website optional | نوع: string optional The authoritative website for this Place, such as a business' homepage. Only available with PlacesService.getDetails . |
PlaceAspectRating interface
google.maps.places . PlaceAspectRating
interface
Defines information about an aspect of the place that users have reviewed.
خواص | |
---|---|
rating | Type: number The rating of this aspect. For individual reviews this is an integer from 0 to 3. For aggregated ratings of a place this is an integer from 0 to 30. |
type | نوع: string The aspect type. For example, "food" , "decor" , "service" , or "overall" . |
BusinessStatus constants
google.maps.places . BusinessStatus
constants
The operational status of the Place, if it is a business, returned in a PlaceResult (indicates whether the place is operational, or closed either temporarily or permanently). Specify these by value, or the constant's name (example: 'OPERATIONAL'
or google.maps.places.BusinessStatus.OPERATIONAL
).
Access by calling const {BusinessStatus} = await google.maps.importLibrary("places")
. کتابخانه ها را در Maps JavaScript API ببینید.
ثابت ها | |
---|---|
CLOSED_PERMANENTLY | The business is closed permanently. |
CLOSED_TEMPORARILY | The business is closed temporarily. |
OPERATIONAL | The business is operating normally. |
PlaceGeometry interface
google.maps.places . PlaceGeometry
interface
Defines information about the geometry of a Place.
خواص | |
---|---|
location optional | نوع: LatLng optional The Place's position. |
viewport optional | Type: LatLngBounds optional The preferred viewport when displaying this Place on a map. This property will be null if the preferred viewport for the Place is not known. Only available with PlacesService.getDetails . |
PlaceOpeningHours interface
google.maps.places . PlaceOpeningHours
interface
Defines information about the opening hours of a Place.
خواص | |
---|---|
open_now optional open_now optional | نوع: boolean optional Whether the Place is open at the current time. |
periods optional | Type: Array < PlaceOpeningHoursPeriod > optional Opening periods covering for each day of the week, starting from Sunday, in chronological order. Days in which the Place is not open are not included. Only available with PlacesService.getDetails . |
weekday_text optional | Type: Array <string> optional An array of seven strings representing the formatted opening hours for each day of the week. The Places Service will format and localize the opening hours appropriately for the current language. The ordering of the elements in this array depends on the language. Some languages start the week on Monday while others start on Sunday. Only available with PlacesService.getDetails . Other calls may return an empty array. |
مواد و روش ها | |
---|---|
isOpen | isOpen([date]) مولفه های:
Return Value: boolean|undefined Check whether the place is open now (when no date is passed), or at the given date. If this place does not have PlaceResult.utc_offset_minutes or PlaceOpeningHours.periods then undefined is returned ( PlaceOpeningHours.periods is only available via PlacesService.getDetails ). This method does not take exceptional hours, such as holiday hours, into consideration. |
PlaceOpeningHoursPeriod interface
google.maps.places . PlaceOpeningHoursPeriod
interface
Defines structured information about the opening hours of a Place. Note: If a Place is always open , the close
section will be missing from the response. Clients can rely on always-open being represented as an open
period containing day
with value 0
and time
with value "0000"
, and no close
.
خواص | |
---|---|
open | Type: PlaceOpeningHoursTime The opening time for the Place. |
close optional | Type: PlaceOpeningHoursTime optional The closing time for the Place. |
PlaceOpeningHoursTime interface
google.maps.places . PlaceOpeningHoursTime
interface
Defines when a Place opens or closes.
خواص | |
---|---|
day | Type: number The days of the week, as a number in the range [ 0 , 6 ], starting on Sunday. For example, 2 means Tuesday. |
hours | Type: number The hours of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 23 ]. This will be reported in the Place's time zone. |
minutes | Type: number The minutes of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 59 ]. This will be reported in the Place's time zone. |
time | نوع: string The time of day in 24-hour "hhmm" format. Values are in the range [ "0000" , "2359" ]. The time will be reported in the Place's time zone. |
nextDate optional | نوع: number optional The timestamp (as milliseconds since the epoch, suitable for use with new Date() ) representing the next occurrence of this PlaceOpeningHoursTime. It is calculated from the PlaceOpeningHoursTime.day of week, the PlaceOpeningHoursTime.time , and the PlaceResult.utc_offset_minutes . If the PlaceResult.utc_offset_minutes is undefined , then nextDate will be undefined . |
PlacePlusCode interface
google.maps.places . PlacePlusCode
interface
Defines Open Location Codes or " plus codes " for a Place. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named).
خواص | |
---|---|
global_code | نوع: string A plus code with a 1/8000th of a degree by 1/8000th of a degree area. For example, "8FVC9G8F+5W" . |
compound_code optional | نوع: string optional A plus code with a 1/8000th of a degree by 1/8000th of a degree area where the first four characters (the area code) are dropped and replaced with a locality description. For example, "9G8F+5W Zurich, Switzerland" . If no suitable locality that can be found to shorten the code then this field is omitted. |
PlacePhoto interface
google.maps.places . PlacePhoto
interface
Represents a photo element of a Place.
خواص | |
---|---|
height | Type: number The height of the photo in pixels. |
html_attributions | Type: Array <string> Attribution text to be displayed for this photo. |
width | Type: number The width of the photo in pixels. |
مواد و روش ها | |
---|---|
getUrl | getUrl([opts]) مولفه های:
Return Value: string Returns the image URL corresponding to the specified options. |
PhotoOptions interface
google.maps.places . PhotoOptions
interface
Defines photo-requesting options.
خواص | |
---|---|
maxHeight optional | نوع: number optional The maximum height in pixels of the returned image. |
maxWidth optional | نوع: number optional The maximum width in pixels of the returned image. |
PlaceReview interface
google.maps.places . PlaceReview
interface
Represents a single review of a place.
خواص | |
---|---|
author_name | نوع: string The name of the reviewer. |
language | نوع: string An IETF language code indicating the language in which this review is written. Note that this code includes only the main language tag without any secondary tag indicating country or region. For example, all the English reviews are tagged as 'en' rather than 'en-AU' or 'en-UK'. |
profile_photo_url | نوع: string A URL to the reviwer's profile image. |
relative_time_description | نوع: string A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country. For example "a month ago" . |
text | نوع: string The text of a review. |
time | Type: number Timestamp for the review, expressed in seconds since epoch. |
aspects optional aspects optional | Type: Array < PlaceAspectRating > optional The aspects rated by the review. The ratings on a scale of 0 to 3. |
author_url optional | نوع: string optional A URL to the reviewer's profile. This will be undefined when the reviewer's profile is unavailable. |
rating optional | نوع: number optional The rating of this review, a number between 1.0 and 5.0 (inclusive). |