انواع مکان (جدید)

مقدمه

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

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

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

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

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

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

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

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

جدول C مجموعه‌های نوعی را فهرست می‌کند که می‌توانند به‌عنوان مقدار پارامتر includedPrimaryTypes در درخواست «تکمیل خودکار (جدید)» استفاده شوند. مجموعه‌های نوع را نمی‌توان با هیچ مقدار نوع دیگری مشخص کرد.

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

جدول الف

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

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

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

جدول ب

مقادیر نوع «مکان» در «جدول ب» ممکن است به‌عنوان بخشی از پاسخ «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، «جستجوی نوشتاری» (جدید)، یا «تکمیل خودکار» (جدید) برگردانده شود. این نوع‌ها برای درخواست‌های «تکمیل خودکار» (جدید) توسط 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

جدول C

از مجموعه‌های نوع می‌توان به‌عنوان مقدار includedPrimaryTypes در درخواست‌های «تکمیل خودکار» (جدید) استفاده کرد. استفاده از مجموعه نوع همه نتایجی را که با هریک از انواع مرتبط گنجانده‌شده مطابقت دارند برمی‌گرداند. مجموعه‌های نوع را نمی‌توان با مقادیر نوع دیگر مشخص کرد.

مجموعه قلم‌ها	انواع گنجانده‌شده
(regions)	فیلترهایی برای مناطق یا بخش‌ها، مثل محله‌ها و کد پستی.
(cities)	فیلترهایی برای مکان‌هایی که Google به‌عنوان شهر شناسایی می‌کند.

انواع نشانی و انواع عنصر نشانی

آرایه types در پاسخ نشان‌دهنده نوع نشانی است. نمونه‌هایی از انواع نشانی عبارت‌اند از نشانی خیابان، کشور، یا نهاد سیاسی. آرایه types در فیلد 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	مرجع مکان کدبندی‌شده، برگرفته از طول و عرض جغرافیایی. در مکان‌هایی که نشانی خیابان وجود ندارد (ساختمان‌ها شماره‌گذاری نشده‌اند یا خیابان‌ها نام‌گذاری نشده‌اند)، می‌توان از کدهای باز به‌عنوان جایگزین نشانی خیابان استفاده کرد. برای جزئیات، به 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	مکان ایستگاه اتوبوس، قطار، یا حمل‌ونقل عمومی.