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

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

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

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

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

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

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

• به عنوان بخشی از پاسخ از Place Details (جدید)، Nearby Search (جدید) و Text Search (جدید)، مقادیر موجود در جدول A برای پر کردن ویژگی types از نمونه Place استفاده می‌شوند. درخواست باید Place.Field.TYPES یا Place.Field.PRIMARY_TYPE را در لیست فیلدها مشخص کند.
• به عنوان بخشی از درخواست جستجوی نزدیک (جدید)، به عنوان مقدار پارامترهای انواع شامل شده، انواع حذف شده، انواع اصلی شامل شده و انواع اصلی حذف شده استفاده می‌شود.
• به عنوان بخشی از درخواست جستجوی متن (جدید)، به عنوان مقدار پارامتر نوع گنجانده شده استفاده می‌شود.
• به عنوان بخشی از درخواست Place Autocomplete (New)، از مقادیر پارامتر primary types استفاده کنید.
• به عنوان بخشی از پاسخ Place Autocomplete (New) که برای پر کردن ویژگی types از نمونه AutocompletePrediction استفاده می‌شود.

جدول B مقادیر نوع مکان اضافی را فهرست می‌کند که ممکن است به عنوان بخشی از پاسخ‌های جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید) و تکمیل خودکار مکان (جدید) نیز بازگردانده شوند. درخواست باید Place.Field.TYPES یا Place.Field.PRIMARY_TYPE در لیست فیلدها مشخص کند. مقادیر جدول B به عنوان بخشی از یک درخواست استفاده نمی‌شوند، مگر به عنوان مقادیر پارامتر انواع اصلی برای درخواست تکمیل خودکار مکان (جدید).

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

جدول الف

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

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

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

انواع آدرس و انواع مؤلفه آدرس

enum مربوط getPlaceTypes در پاسخ، نوع آدرس را نشان می‌دهد. نمونه‌هایی از انواع آدرس شامل آدرس خیابان، کشور یا یک نهاد سیاسی است. آرایه 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	یک نقطه مورد علاقه نامگذاری شده. معمولاً این "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	محل ایستگاه اتوبوس، قطار یا وسایل حمل و نقل عمومی.