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

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

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

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

  • یک مکان می‌تواند یک نوع اصلی از نوع جدول 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
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
winery *
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
yakitori_restaurant *
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

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

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 محل ایستگاه اتوبوس، قطار یا وسایل حمل و نقل عمومی.