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

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

انواع مکان

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

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

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

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

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

درباره جدول‌های نوع

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

به‌عنوان بخشی از پاسخ از «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، و «جستجوی نوشتار» (جدید). سپس از مقادیر موجود در «جدول الف» برای پر کردن آن فیلدها استفاده می‌شود.
به‌عنوان بخشی از درخواست «جستجوی اطراف» (جدید)، به‌عنوان مقدار پارامترهای includedTypes، excludedTypes، includedPrimaryTypes، و excludedPrimaryTypes استفاده می‌شود. سپس از مقادیر موجود در جدول B برای پر کردن آن فیلدها استفاده می‌شود.
به‌عنوان بخشی از درخواست «جستجوی نوشتاری (جدید)»، به‌عنوان مقدار پارامتر includedType استفاده می‌شود.
به‌عنوان بخشی از درخواست «ابزاره تکمیل خودکار جا» (جدید)، از آن به‌عنوان مقادیر پارامتر includedPrimaryTypes استفاده کنید.
به‌عنوان بخشی از پاسخ «ابزاره تکمیل خودکار جا (جدید)».

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

انواع نشانی و انواع مؤلفه نشانی انواع فهرست‌هایی را که ممکن است در آرایه‌های نوع نشانی یا نوع مؤلفه نشانی یا هر دو در بدنه پاسخ ظاهر شوند، فهرست می‌کند. انواع مؤلفه نشانی ممکن است تغییر کند.

جدول الف

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

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

Automotive
`car_dealer` `car_rental` `car_repair` `car_wash` `ebike_charging_station` * `electric_vehicle_charging_station` `gas_station`	`parking` `parking_garage` * `parking_lot` * `rest_stop` `tire_shop` * `truck_dealer` *
کسب‌وکار
`business_center` * `corporate_office` `coworking_space` * `farm` `manufacturer` * `ranch` `supplier` * `television_studio` *
فرهنگ
`art_gallery` `art_museum` * `art_studio` `auditorium` `castle` * `cultural_landmark` `fountain` * `historical_place` `history_museum` *	`monument` `museum` `performing_arts_theater` `sculpture`
آموزشی
`academic_department` * `educational_institution` * `library` `preschool` `primary_school`	`research_institute` * `school` `secondary_school` `university`
تفریح و سرگرمی
`adventure_sports_center` `amphitheatre` `amusement_center` `amusement_park` `aquarium` `banquet_hall` `barbecue_area` `botanical_garden` `bowling_alley` `casino` `childrens_camp` `city_park` * `comedy_club` `community_center` `concert_hall` `convention_center` `cultural_center` `cycling_park` `dance_hall` `dog_park` `event_venue` `ferris_wheel` `garden` `go_karting_venue` *	`hiking_area` `historical_landmark` `indoor_playground` * `internet_cafe` `karaoke` `live_music_venue` * `marina` `miniature_golf_course` * `movie_rental` `movie_theater` `national_park` `night_club` `observation_deck` `off_roading_area` `opera_house` `paintball_center` * `park` `philharmonic_hall` `picnic_ground` `planetarium` `plaza` `roller_coaster` `skateboard_park` `state_park`	`tourist_attraction` `video_arcade` `vineyard` * `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` `argentinian_restaurant` * `asian_fusion_restaurant` * `asian_restaurant` `australian_restaurant` * `austrian_restaurant` * `bagel_shop` `bakery` `bangladeshi_restaurant` * `bar` `bar_and_grill` `barbecue_restaurant` `basque_restaurant` * `bavarian_restaurant` * `beer_garden` * `belgian_restaurant` * `bistro` * `brazilian_restaurant` `breakfast_restaurant` `brewery` * `brewpub` * `british_restaurant` * `brunch_restaurant` `buffet_restaurant` `burmese_restaurant` * `burrito_restaurant` * `cafe` `cafeteria` `cajun_restaurant` * `cake_shop` * `californian_restaurant` * `cambodian_restaurant` * `candy_store` `cantonese_restaurant` * `caribbean_restaurant` * `cat_cafe` `chicken_restaurant` * `chicken_wings_restaurant` * `chilean_restaurant` * `chinese_noodle_restaurant` * `chinese_restaurant` `chocolate_factory` `chocolate_shop` `cocktail_bar` * `coffee_roastery` * `coffee_shop` `coffee_stand` * `colombian_restaurant` * `confectionery` `croatian_restaurant` * `cuban_restaurant` * `czech_restaurant` * `danish_restaurant` * `deli`	`dessert_restaurant` `dessert_shop` `dim_sum_restaurant` * `diner` `dog_cafe` `donut_shop` `dumpling_restaurant` * `dutch_restaurant` * `eastern_european_restaurant` * `ethiopian_restaurant` * `european_restaurant` * `falafel_restaurant` * `family_restaurant` * `fast_food_restaurant` `filipino_restaurant` * `fine_dining_restaurant` `fish_and_chips_restaurant` * `fondue_restaurant` * `food_court` `french_restaurant` `fusion_restaurant` * `gastropub` * `german_restaurant` * `greek_restaurant` `gyro_restaurant` * `halal_restaurant`* `hamburger_restaurant` `hawaiian_restaurant` * `hookah_bar` * `hot_dog_restaurant` * `hot_dog_stand` * `hot_pot_restaurant` * `hungarian_restaurant` * `ice_cream_shop` `indian_restaurant` `indonesian_restaurant` `irish_pub` * `irish_restaurant` * `israeli_restaurant` * `italian_restaurant` `japanese_curry_restaurant` * `japanese_izakaya_restaurant` * `japanese_restaurant` `juice_shop` `kebab_shop` * `korean_barbecue_restaurant` * `korean_restaurant` `latin_american_restaurant` * `lebanese_restaurant` `lounge_bar` * `malaysian_restaurant` * `meal_delivery` `meal_takeaway` `mediterranean_restaurant` `mexican_restaurant` `middle_eastern_restaurant` `mongolian_barbecue_restaurant` *	`moroccan_restaurant` * `noodle_shop` * `north_indian_restaurant` * `oyster_bar_restaurant` * `pakistani_restaurant` * `pastry_shop` * `persian_restaurant` * `peruvian_restaurant` * `pizza_delivery` * `pizza_restaurant` `polish_restaurant` * `portuguese_restaurant` * `pub` `ramen_restaurant` `restaurant` `romanian_restaurant` * `russian_restaurant` * `salad_shop` * `sandwich_shop` `scandinavian_restaurant` * `seafood_restaurant` `shawarma_restaurant` * `snack_bar` * `soul_food_restaurant` * `soup_restaurant` * `south_american_restaurant` * `south_indian_restaurant` * `southwestern_us_restaurant` * `spanish_restaurant` `sports_bar` * `sri_lankan_restaurant` * `steak_house` `sushi_restaurant` `swiss_restaurant` * `taco_restaurant` * `taiwanese_restaurant` * `tapas_restaurant` * `tea_house` `tex_mex_restaurant` * `thai_restaurant` `tibetan_restaurant` * `tonkatsu_restaurant` * `turkish_restaurant` `ukrainian_restaurant` * `vegan_restaurant` `vegetarian_restaurant` `vietnamese_restaurant` `western_restaurant` * `wine_bar` `winery` * `yakiniku_restaurant` * `yakitori_restaurant` *
مناطق جغرافیایی
`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` `general_hospital` * `hospital` `massage` `massage_spa` * `medical_center` * `medical_clinic` * `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` `island` * `lake` * `mountain_peak` * `nature_preserve` * `river` * `scenic_spot` * `woods` *
مکان‌های عبادت
`buddhist_temple` * `church` `hindu_temple` `mosque` `shinto_shrine` * `synagogue`
خدمات
‫`aircraft_rental_service` * `association_or_organization` * `astrologer` `barber_shop` `beautician` `beauty_salon` `body_art_service` `catering_service` `cemetery` `chauffeur_service` * `child_care_agency` `consultant` `courier_service` `electrician` `employment_agency` * `florist` `food_delivery` `foot_care` `funeral_home` `hair_care` `hair_salon` `insurance_agency` `laundry` `lawyer` `locksmith`	`makeup_artist` `marketing_consultant` * `moving_company` `nail_salon` `non_profit_organization` * `painter` `pet_boarding_service` * `pet_care` * `plumber` `psychic` `real_estate_agency` `roofing_contractor` `service` * `shipping_service` * `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` `building_materials_store` * `butcher_shop` `cell_phone_store` `clothing_store` `convenience_store` `cosmetics_store` * `department_store` `discount_store` `discount_supermarket` * `electronics_store` `farmers_market` * `flea_market` * `food_store` `furniture_store` `garden_center` * `general_store` * `gift_shop` `grocery_store` `hardware_store` `health_food_store` * `home_goods_store`	`home_improvement_store` `hypermarket` * `jewelry_store` `liquor_store` `market` `pet_store` `shoe_store` `shopping_mall` `sporting_goods_store` `sportswear_store` * `store` `supermarket` `tea_store` * `thrift_store` * `toy_store` * `warehouse_store` `wholesaler` `womens_clothing_store` *
ورزشگاه‌ها
`arena` `athletic_field` `fishing_charter` `fishing_pier` * `fishing_pond` `fitness_center` `golf_course` `gym` `ice_skating_rink` `indoor_golf_course` *	`playground` `race_course` * `ski_resort` `sports_activity_location` `sports_club` `sports_coaching` `sports_complex` `sports_school` * `stadium` `swimming_pool` * `tennis_court` *
حمل‌ونقل
‫`airport` `airstrip` `bike_sharing_station` * `bridge` * `bus_station` `bus_stop` `ferry_service` * `ferry_terminal` `heliport` `international_airport` `light_rail_station` `park_and_ride`	`subway_station` `taxi_service` * `taxi_stand` `toll_station` * `train_station` `train_ticket_office` * `tram_stop` * `transit_depot` `transit_station` `transit_stop` * `transportation_service` * `truck_stop`

جدول ب

مقادیر نوع «مکان» در جدول 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`	نهاد سیاسی ملی، و معمولاً بالاترین نوع ترتیبی است که توسط «زمین‌کدیاب» برگردانده می‌شود.
`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`	مرجع مکان کدگذاری‌شده، برگرفته از عرض جغرافیایی و طول جغرافیایی. در جاهایی که نشانی خیابان وجود ندارد (ساختمان‌ها شماره ندارند یا خیابان‌ها نام ندارند)، می‌توان از Plus Code به‌جای نشانی خیابان استفاده کرد. برای جزئیات، به https://plus.codes بروید.
`postal_code`	کد پستی که برای نشانی پستی در کشور استفاده می‌شود.
`natural_feature`	عارضه طبیعی برجسته.
`airport`	فرودگاه.
`park`	پارک نام‌گذاری‌شده.
`point_of_interest`	نقطه موردعلاقه نام‌گذاری‌شده. معمولاً این «نقاط موردعلاقه» نهادهای محلی برجسته‌ای هستند که به‌راحتی در دسته دیگری قرار نمی‌گیرند، مثل «ساختمان امپایر استیت» یا «برج ایفل».

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

علاوه‌بر موارد بالا، مؤلفه‌های نشانی ممکن است شامل انواع فهرست‌شده در زیر باشد.

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