انواع مکان دسته بندی هایی هستند که ویژگی های یک مکان را مشخص می کنند. یک مکان می تواند یک یا چند نوع مکان به آن اختصاص داده شود.
انواع مکان در پاسخ از درخواست جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید)، و تکمیل خودکار مکان (جدید) گنجانده شده است:
- یک مکان می تواند دارای یک نوع اولیه از نوع جدول A یا نوع جدول B مرتبط با آن باشد. به عنوان مثال، نوع اولیه ممکن است
mexican_restaurant
یاsteak_house
باشد. - یک مکان می تواند چندین مقدار از نوع جدول A یا نوع جدول B مرتبط با آن داشته باشد. برای مثال یک رستوران ممکن است انواع زیر را داشته باشد:
seafood_restaurant
،restaurant
،food
،point_of_interest
،establishment
. - اجزای آدرس و آدرس یک مکان را می توان با انواع خاصی از جدول انواع آدرس و انواع اجزای آدرس برچسب گذاری کرد. برای مثال، یک آدرس ممکن است به عنوان
street_address
و یک جزء از آدرس ممکن است به عنوانstreet_number
برچسب گذاری شود.
همچنین می توانید انواع مکان را به عنوان بخشی از یک درخواست مشخص کنید. هنگامی که در درخواست مشخص می شود، نوع به عنوان یک فیلتر عمل می کند تا پاسخ را فقط شامل مکان هایی که با انواع مشخص شده مطابقت دارند محدود کند.
در مورد جداول نوع
جدول A انواعی را که به روش های زیر استفاده می شوند فهرست می کند:
- به عنوان بخشی از پاسخ از جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، و جستجوی متن (جدید). درخواست باید حداقل یکی از فیلدهای
places.types
یاplaces.primaryType
را در فیلد ماسک مشخص کند. سپس از مقادیر جدول A برای پر کردن آن فیلدها استفاده می شود. - به عنوان بخشی از یک درخواست Nearby Search (جدید)، به عنوان مقدار پارامتر
includedTypes
،excludedTypes
،includedPrimaryTypes
وexcludedPrimaryTypes
استفاده میشود. سپس از مقادیر جدول B برای پر کردن آن فیلدها استفاده می شود. - به عنوان بخشی از یک درخواست جستجوی متن (جدید)، که به عنوان مقدار پارامتر
includedType
استفاده می شود. - به عنوان بخشی از یک درخواست تکمیل خودکار (جدید)، به عنوان مقادیر پارامتر
includedPrimaryTypes
استفاده کنید. - به عنوان بخشی از پاسخ تکمیل خودکار (جدید).
جدول B مقادیر اضافی نوع مکان را فهرست می کند که ممکن است به عنوان بخشی از پاسخ جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، جستجوی متن (جدید)، و تکمیل خودکار (جدید) برگردانده شوند. درخواست باید حداقل یکی از فیلدهای places.types
یا places.primaryType
را در فیلد ماسک مشخص کند. مقادیر جدول B نمی توانند به عنوان بخشی از یک درخواست استفاده شوند، مگر به عنوان مقادیر پارامتر includedPrimaryTypes
برای یک درخواست تکمیل خودکار (جدید).
انواع آدرس و انواع اجزای آدرس، انواعی را فهرست می کند که ممکن است در هر یک یا هر دو آرایه نوع آدرس و نوع جزء آدرس در بدنه پاسخ ظاهر شوند. انواع اجزای آدرس در معرض تغییر هستند.
جدول 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 hostel guest_house *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
در قسمت 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 | محل ایستگاه اتوبوس، قطار یا حمل و نقل عمومی. |