Places UI Kit : یک کتابخانه آماده برای استفاده که فضایی را برای سفارشی‌سازی و توسعه کم کد فراهم می‌کند. آن را امتحان کنید و نظرات خود را در مورد تجربه کیت UI خود به اشتراک بگذارید.

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

انواع مکان

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

انواع مکان دسته بندی هایی هستند که ویژگی های یک مکان را مشخص می کنند. یک مکان می تواند یک یا چند نوع مکان به آن اختصاص داده شود.

انواع مکان در پاسخ از درخواست جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید) و تکمیل خودکار (جدید) گنجانده شده است:

یک مکان می تواند دارای یک نوع اولیه از نوع جدول A یا نوع جدول B مرتبط با آن باشد. به عنوان مثال، نوع اصلی ممکن است mexican_restaurant یا steak_house باشد. اگر نوع اصلی مکان، نوع پشتیبانی‌شده نباشد، ممکن است نوع اولیه وجود نداشته باشد. وقتی یک نوع اولیه وجود دارد، همیشه یکی از انواع در فیلد types است.
یک مکان می تواند چندین مقدار از نوع جدول A یا نوع جدول B مرتبط با آن داشته باشد. برای مثال یک رستوران ممکن است انواع زیر را داشته باشد: seafood_restaurant ، restaurant ، food ، point_of_interest ، establishment .
اجزای آدرس و آدرس یک مکان را می توان با انواع خاصی از جدول انواع آدرس و انواع اجزای آدرس برچسب گذاری کرد. برای مثال، یک آدرس ممکن است به عنوان street_address و یک جزء از آدرس ممکن است به عنوان street_number برچسب گذاری شود.

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

در مورد جداول نوع

جدول A مقادیر پشتیبانی شده را برای انواع مکان فهرست می کند:

به عنوان بخشی از پاسخ از جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، و جستجوی متن (جدید). سپس از مقادیر جدول A برای پر کردن آن فیلدها استفاده می شود.
به عنوان بخشی از یک درخواست Nearby Search (جدید)، به عنوان مقدار پارامتر includedTypes ، excludedTypes ، includedPrimaryTypes و excludedPrimaryTypes استفاده می‌شود. سپس از مقادیر جدول B برای پر کردن آن فیلدها استفاده می شود.
به عنوان بخشی از یک درخواست جستجوی متن (جدید)، که به عنوان مقدار پارامتر includedType استفاده می شود.
به عنوان بخشی از درخواست Place Autocomplete Widget (جدید)، به عنوان مقادیر پارامتر includedPrimaryTypes استفاده کنید.
به عنوان بخشی از پاسخ ویجت تکمیل خودکار مکان (جدید).

جدول B مقادیر اضافی نوع مکان را فهرست می کند که ممکن است به عنوان بخشی از پاسخ جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید)، و ابزارک تکمیل خودکار مکان (جدید) برگردانده شوند. درخواست باید حداقل یکی از فیلدهای places.types یا places.primaryType را در فیلد ماسک مشخص کند. مقادیر جدول B نمی توانند به عنوان بخشی از یک درخواست استفاده شوند، مگر به عنوان مقادیر پارامتر includedPrimaryTypes برای یک درخواست Place Autocomplete Widget (جدید).

انواع آدرس و انواع اجزای آدرس، انواعی را فهرست می کند که ممکن است در هر یک یا هر دو آرایه نوع آدرس و نوع جزء آدرس در بدنه پاسخ ظاهر شوند. انواع اجزای آدرس در معرض تغییر هستند.

جدول A

خودرو
تجارت
فرهنگ
آموزش و پرورش
سرگرمی و تفریح
امکانات *
امور مالی
غذا و نوشیدنی
مناطق جغرافیایی
دولت

سلامتی و تندرستی
مسکن *
اسکان
ویژگی های طبیعی *
عبادتگاه ها
خدمات
خرید
ورزش
حمل و نقل

خودرو
`car_dealer` `car_rental` `car_repair` `car_wash`	`electric_vehicle_charging_station` `gas_station` `parking` `rest_stop`
تجارت
`corporate_office` * `farm` `ranch` *
فرهنگ
`art_gallery` `art_studio` * `auditorium` * `cultural_landmark` * `historical_place` *	`monument` * `museum` `performing_arts_theater` `sculpture` *
آموزش و پرورش
`library` `preschool` `primary_school`	`school` `secondary_school` `university`
سرگرمی و تفریح
`adventure_sports_center` * `amphitheatre` * `amusement_center` `amusement_park` `aquarium` `banquet_hall` `barbecue_area` * `botanical_garden` * `bowling_alley` `casino` `childrens_camp` * `comedy_club` * `community_center` `concert_hall` * `convention_center` `cultural_center` `cycling_park` * `dance_hall` * `dog_park` `event_venue`	`ferris_wheel` * `garden` * `hiking_area` * `historical_landmark` `internet_cafe` * `karaoke` * `marina` `movie_rental` `movie_theater` `national_park` `night_club` `observation_deck` * `off_roading_area` * `opera_house` * `park` `philharmonic_hall` * `picnic_ground` * `planetarium` * `plaza` * `roller_coaster` *	`skateboard_park` * `state_park` * `tourist_attraction` `video_arcade` * `visitor_center` `water_park` * `wedding_venue` `wildlife_park` * `wildlife_refuge` * `zoo`
امکانات
`public_bath` * `public_bathroom` * `stable` *
امور مالی
`accounting` `atm` `bank`
غذا و نوشیدنی
`acai_shop` * `afghani_restaurant` * `african_restaurant` * `american_restaurant` `asian_restaurant` * `bagel_shop` * `bakery` `bar` `bar_and_grill` * `barbecue_restaurant` `brazilian_restaurant` `breakfast_restaurant` `brunch_restaurant` `buffet_restaurant` * `cafe` `cafeteria` * `candy_store` * `cat_cafe` * `chinese_restaurant` `chocolate_factory` * `chocolate_shop` * `coffee_shop` `confectionery` *	`deli` * `dessert_restaurant` * `dessert_shop` * `diner` * `dog_cafe` * `donut_shop` * `fast_food_restaurant` `fine_dining_restaurant` * `food_court` * `french_restaurant` `greek_restaurant` `hamburger_restaurant` `ice_cream_shop` `indian_restaurant` `indonesian_restaurant` `italian_restaurant` `japanese_restaurant` `juice_shop` * `korean_restaurant` * `lebanese_restaurant` `meal_delivery` `meal_takeaway` `mediterranean_restaurant`	`mexican_restaurant` `middle_eastern_restaurant` `pizza_restaurant` `pub` * `ramen_restaurant` `restaurant` `sandwich_shop` `seafood_restaurant` `spanish_restaurant` `steak_house` `sushi_restaurant` `tea_house` * `thai_restaurant` `turkish_restaurant` `vegan_restaurant` `vegetarian_restaurant` `vietnamese_restaurant` `wine_bar` *
مناطق جغرافیایی
`administrative_area_level_1` `administrative_area_level_2` `country`	`locality` `postal_code` `school_district`
دولت
`city_hall` `courthouse` `embassy` `fire_station` `government_office` *	`local_government_office` `neighborhood_police_station` (فقط ژاپن) `police` `post_office`
سلامتی و تندرستی
`chiropractor` * `dental_clinic` `dentist` `doctor` `drugstore` `hospital` `massage` * `medical_lab` *	`pharmacy` `physiotherapist` `sauna` * `skin_care_clinic` * `spa` `tanning_studio` * `wellness_center` * `yoga_studio` *
مسکن
`apartment_building` * `apartment_complex` * `condominium_complex` * `housing_complex` *
اسکان
`bed_and_breakfast` `budget_japanese_inn` * `campground` `camping_cabin` `cottage` `extended_stay_hotel` `farmstay` `guest_house` `hostel` * `hotel` *	`inn` * `japanese_inn` * `lodging` `mobile_home_park` * `motel` `private_guest_room` `resort_hotel` `rv_park`
ویژگی های طبیعی
`beach` *
عبادتگاه ها
`church` `hindu_temple` `mosque` `synagogue`
خدمات
`astrologer` * `barber_shop` `beautician` * `beauty_salon` `body_art_service` * `catering_service` * `cemetery` `child_care_agency` `consultant` `courier_service` `electrician` `florist` `food_delivery` * `foot_care` * `funeral_home` `hair_care` `hair_salon` `insurance_agency` `laundry` *	`lawyer` `locksmith` `makeup_artist` * `moving_company` `nail_salon` * `painter` `plumber` `psychic` * `real_estate_agency` `roofing_contractor` `storage` `summer_camp_organizer` * `tailor` `telecommunications_service_provider` `tour_agency` * `tourist_information_center` * `travel_agency` `veterinary_care`
خرید
`asian_grocery_store` * `auto_parts_store` `bicycle_store` `book_store` `butcher_shop` * `cell_phone_store` `clothing_store` `convenience_store` `department_store` `discount_store` `electronics_store` `food_store` * `furniture_store` `gift_shop` `grocery_store` `hardware_store` `home_goods_store`	`home_improvement_store` `jewelry_store` `liquor_store` `market` `pet_store` `shoe_store` `shopping_mall` `sporting_goods_store` `store` `supermarket` `warehouse_store` * `wholesaler`
ورزش
`arena` * `athletic_field` `fishing_charter` * `fishing_pond` * `fitness_center` `golf_course` `gym` `ice_skating_rink` *	`playground` * `ski_resort` `sports_activity_location` * `sports_club` `sports_coaching` * `sports_complex` `stadium` `swimming_pool`
حمل و نقل
`airport` `airstrip` * `bus_station` `bus_stop` `ferry_terminal` `heliport` `international_airport` * `light_rail_station`	`park_and_ride` * `subway_station` `taxi_stand` `train_station` `transit_depot` `transit_station` `truck_stop`

جدول B

مقادیر نوع مکان در جدول B ممکن است به عنوان بخشی از پاسخ جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید)، یا تکمیل خودکار (جدید) بازگردانده شوند. این نوع ها همچنین توسط includedPrimaryTypes برای درخواست های تکمیل خودکار (جدید) پشتیبانی می شوند.

مقادیر اضافی نوع مکان
`administrative_area_level_3` `administrative_area_level_4` `administrative_area_level_5` `administrative_area_level_6` `administrative_area_level_7` `archipelago` `colloquial_area` `continent` `establishment` `finance` `food` `general_contractor` `geocode` `health` `intersection` `landmark` `natural_feature` `neighborhood` `place_of_worship` `plus_code`	`point_of_interest` `political` `postal_code_prefix` `postal_code_suffix` `postal_town` `premise` `route` `street_address` `sublocality` `sublocality_level_1` `sublocality_level_2` `sublocality_level_3` `sublocality_level_4` `sublocality_level_5` `subpremise` `town_square`

انواع آدرس و انواع اجزای آدرس

آرایه types در پاسخ نوع آدرس را نشان می دهد. نمونه‌هایی از انواع آدرس‌ها عبارتند از آدرس خیابان، کشور یا یک نهاد سیاسی. آرایه types در کلاس google.maps.places.AddressComponent نوع هر قسمت از آدرس را نشان می دهد. به عنوان مثال می توان به شماره خیابان یا کشور اشاره کرد.

آدرس ها ممکن است انواع مختلفی داشته باشند. انواع ممکن است "برچسب" در نظر گرفته شوند. به عنوان مثال، بسیاری از شهرها با انواع political و locality برچسب گذاری شده اند.

انواع زیر در هر دو آرایه نوع آدرس و نوع جزء آدرس پشتیبانی و برگردانده می شوند:

نوع آدرس	توضیحات
`street_address`	آدرس خیابان دقیق
`route`	یک مسیر نامگذاری شده (مانند "US 101").
`intersection`	یک تقاطع اصلی، معمولاً از دو جاده اصلی.
`political`	یک نهاد سیاسی معمولاً این نوع نشان دهنده چند ضلعی برخی از مدیریت شهری است.
`country`	نهاد سیاسی ملی، و معمولاً بالاترین نوع است که توسط Geocoder بازگردانده می شود.
`administrative_area_level_1`	یک نهاد مدنی درجه یک زیر سطح کشور. در داخل ایالات متحده، این سطوح اداری ایالت ها هستند. همه کشورها این سطوح اداری را نشان نمی دهند. در بیشتر موارد، نام‌های کوتاه `administrative_area_level_1` با زیربخش‌های ISO 3166-2 و سایر فهرست‌های پرتیراژ بسیار مطابقت دارند. با این حال، این تضمین نمی شود، زیرا نتایج جغرافیایی ما بر اساس سیگنال های مختلف و داده های مکان است.
`administrative_area_level_2`	یک نهاد مدنی درجه دوم زیر سطح کشور. در داخل ایالات متحده، این سطوح اداری شهرستان ها هستند. همه کشورها این سطوح اداری را نشان نمی دهند.
`administrative_area_level_3`	یک نهاد مدنی درجه سوم زیر سطح کشور. این نوع نشان دهنده یک تقسیم مدنی جزئی است. همه کشورها این سطوح اداری را نشان نمی دهند.
`administrative_area_level_4`	یک نهاد مدنی درجه چهارم زیر سطح کشور. این نوع نشان دهنده یک تقسیم مدنی جزئی است. همه کشورها این سطوح اداری را نشان نمی دهند.
`administrative_area_level_5`	یک نهاد مدنی درجه پنجم زیر سطح کشور. این نوع نشان دهنده یک تقسیم مدنی جزئی است. همه کشورها این سطوح اداری را نشان نمی دهند.
`administrative_area_level_6`	یک نهاد مدنی درجه شش زیر سطح کشور. این نوع نشان دهنده یک تقسیم مدنی جزئی است. همه کشورها این سطوح اداری را نشان نمی دهند.
`administrative_area_level_7`	یک نهاد مدنی درجه هفتم زیر سطح کشور. این نوع نشان دهنده یک تقسیم مدنی جزئی است. همه کشورها این سطوح اداری را نشان نمی دهند.
`colloquial_area`	یک نام جایگزین رایج برای نهاد.
`locality`	یک نهاد سیاسی یک شهر یا شهرک.
`sublocality`	یک نهاد مدنی درجه یک در زیر یک منطقه. برای برخی مکان‌ها ممکن است یکی از انواع اضافی دریافت شود: `sublocality_level_1` تا `sublocality_level_5` . هر سطح فرعی یک نهاد مدنی است. اعداد بزرگتر نشان دهنده یک منطقه جغرافیایی کوچکتر است.
`neighborhood`	محله ای به نام
`premise`	یک مکان نامگذاری شده، معمولاً یک ساختمان یا مجموعه ای از ساختمان ها با نام مشترک.
`subpremise`	موجودی قابل آدرس دهی در زیر سطح محل، مانند آپارتمان، واحد یا سوئیت.
`plus_code`	مرجع مکان کدگذاری شده، برگرفته از طول و عرض جغرافیایی. کدهای پلاس می توانند به عنوان جایگزینی برای آدرس های خیابان ها در مکان هایی که وجود ندارند (جایی که ساختمان ها شماره گذاری نشده اند یا خیابان ها نامگذاری نشده اند) استفاده شود. برای جزئیات بیشتر به https://plus.codes مراجعه کنید.
`postal_code`	کد پستی که برای آدرس دهی نامه های پستی در داخل کشور استفاده می شود.
`natural_feature`	یک ویژگی طبیعی بارز.
`airport`	یک فرودگاه
`park`	پارکی به نام
`point_of_interest`	یک نقطه مورد علاقه با نام به طور معمول، این "POI" نهادهای محلی برجسته ای هستند که به راحتی در دسته بندی دیگری مانند "امپایر استیت بیلدینگ" یا "برج ایفل" قرار نمی گیرند.

یک لیست خالی از انواع نشان می دهد که هیچ نوع شناخته شده ای برای جزء آدرس خاص وجود ندارد (به عنوان مثال، Lieu-dit در فرانسه).

علاوه بر موارد فوق، اجزای آدرس ممکن است شامل انواع ذکر شده در زیر باشد.

نوع مؤلفه آدرس	توضیحات
`floor`	آدرس طبقه یک ساختمان.
`establishment`	به طور معمول مکانی است که هنوز طبقه بندی نشده است.
`landmark`	یک مکان نزدیک که به عنوان مرجع برای کمک به ناوبری استفاده می شود.
`point_of_interest`	یک نقطه مورد علاقه با نام
`parking`	یک پارکینگ یا سازه پارکینگ.
`post_box`	یک صندوق پستی خاص
`postal_town`	گروه‌بندی مناطق جغرافیایی، مانند `locality` و `sublocality` ، که برای آدرس‌های پستی در برخی کشورها استفاده می‌شود.
`room`	آدرس اتاق یک ساختمان
`street_number`	شماره خیابان دقیق
`bus_station` ، `train_station` و `transit_station`	محل ایستگاه اتوبوس، قطار یا حمل و نقل عمومی.