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

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

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

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

مقدمه

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

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

یک مکان می‌تواند یک نوع اصلی از نوع جدول 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 (جدید). درخواست باید حداقل یکی از فیلدهای places.types یا places.primaryType را در field mask مشخص کند. سپس از مقادیر جدول A برای پر کردن آن فیلدها استفاده می‌شود.
به عنوان بخشی از درخواست جستجوی نزدیک (جدید)، به عنوان مقدار پارامترهای includedTypes ، excludedTypes ، includedPrimaryTypes و excludedPrimaryTypes استفاده می‌شود. سپس مقادیر موجود در جدول B برای پر کردن آن فیلدها استفاده می‌شوند.
به عنوان بخشی از درخواست جستجوی متن (جدید)، به عنوان مقدار پارامتر includedType استفاده می‌شود.
به عنوان بخشی از یک درخواست تکمیل خودکار (جدید)، از مقادیر پارامتر includedPrimaryTypes استفاده کنید.
به عنوان بخشی از پاسخ تکمیل خودکار (جدید).

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

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

جدول الف

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

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

خودرو
`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`

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

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