مقدمه
انواع مکان دستههایی هستند که ویژگیهای مکان را مشخص میکنند. یک مکان میتواند یک یا چند نوع مکان به آن اختصاص داده شود.
انواع مکان در پاسخ از درخواست «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، «جستجوی نوشتار» (جدید)، و «تکمیل خودکار» (جدید) گنجانده شده است:
- یک مکان میتواند یک نوع اصلی از نوع
جدول الف یا نوع جدول ب مرتبط با آن داشته باشد.
برای مثال، نوع اصلی ممکن است
mexican_restaurantیاsteak_houseباشد. اگر نوع اصلی مکان از نوع پشتیبانیشده نباشد، ممکن است نوع اصلی وجود نداشته باشد. وقتی نوع اصلی وجود داشته باشد، همیشه یکی از انواع در فیلدtypesاست. - یک مکان میتواند چندین مقدار نوع از نوع
جدول الف یا نوع جدول ب مرتبط با آن داشته باشد.
برای مثال، یک رستوران ممکن است انواع زیر را داشته باشد:
seafood_restaurant،restaurant،food،point_of_interest،establishment. - نشانی و مؤلفههای نشانی مکان را میتوان با انواع خاصی از جدول
انواع نشانی و انواع مؤلفه نشانی برچسبگذاری کرد. برای مثال، ممکن است نشانیای بهعنوان
street_addressبرچسبگذاری شود و بخشی از نشانی بهعنوانstreet_numberبرچسبگذاری شود.
همچنین میتوانید انواع مکان را بهعنوان بخشی از درخواست مشخص کنید. وقتی در درخواست مشخص شود، نوع بهعنوان فیلتری عمل میکند تا پاسخ را محدود کند و فقط مکانهایی را که با انواع مشخصشده مطابقت دارند شامل شود.
درباره جدولهای نوع
جدول الف انواع مورداستفاده در روشهای زیر را فهرست میکند:
- بهعنوان بخشی از پاسخ از «جزئیات مکان» (جدید)،
«جستجوی اطراف» (جدید)، و
«جستجوی نوشتار» (جدید). درخواست باید حداقل یکی از فیلدهای
places.typesیاplaces.primaryTypeرا در ماسک فیلد مشخص کند. سپس از مقادیر موجود در جدول الف برای پر کردن آن فیلدها استفاده میشود. - بهعنوان بخشی از درخواست «جستجوی اطراف» (جدید)، بهعنوان مقدار پارامترهای
includedTypes،excludedTypes،includedPrimaryTypes، وexcludedPrimaryTypesاستفاده میشود. سپس از مقادیر جدول «ب» برای پر کردن آن فیلدها استفاده میشود. - بهعنوان بخشی از درخواست «جستجوی نوشتار (جدید)»، بهعنوان
مقدار پارامتر
includedTypeاستفاده میشود. - بهعنوان بخشی از درخواست «تکمیل خودکار (جدید)»،
از آن بهعنوان مقادیر پارامتر
includedPrimaryTypesاستفاده کنید. - بهعنوان بخشی از پاسخ «تکمیل خودکار (جدید)».
جدول B مقادیر نوع مکان اضافی را فهرست میکند که
ممکن است بهعنوان بخشی از پاسخ «جزئیات مکان (جدید)»،
«جستجوی اطراف (جدید)»،
«جستجوی نوشتار (جدید)»، و
«تکمیل خودکار (جدید)» نیز برگردانده شوند. درخواست
باید حداقل یکی از فیلدهای places.types یا
places.primaryType
را در ماسک فیلد مشخص کند. مقادیر جدول ب نباید بهعنوان بخشی از درخواست استفاده شوند، بهجز بهعنوان مقادیر پارامتر includedPrimaryTypes برای درخواست «تکمیل خودکار» (جدید).
جدول C مجموعههای نوعی را فهرست میکند که میتوانند
بهعنوان مقدار پارامتر includedPrimaryTypes در درخواست
«تکمیل خودکار» (جدید) استفاده شوند. مجموعههای نوع را نمیتوان با هیچ مقدار نوع دیگری مشخص کرد.
انواع نشانی و انواع مؤلفه نشانی انواع فهرستهایی را که ممکن است در یکی یا هر دو آرایه نوع نشانی و نوع مؤلفه نشانی در بدنه پاسخ ظاهر شوند، فهرست میکند. انواع مؤلفه نشانی ممکن است تغییر کند.
جدول الف
| Automotive | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| کسبوکار | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| فرهنگ | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| آموزشی | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| تفریح و سرگرمی | ||
adventure_sports_centeramphitheatreamusement_centeramusement_parkaquariumbanquet_hallbarbecue_areabotanical_gardenbowling_alleycasinochildrens_campcity_park *comedy_clubcommunity_centerconcert_hallconvention_centercultural_centercycling_parkdance_halldog_parkevent_venueferris_wheelgardengo_karting_venue * |
hiking_areahistorical_landmarkindoor_playground *internet_cafekaraokelive_music_venue *marinaminiature_golf_course *movie_rentalmovie_theaternational_parknight_clubobservation_deckoff_roading_areaopera_housepaintball_center *parkphilharmonic_hallpicnic_groundplanetariumplazaroller_coasterskateboard_parkstate_park |
tourist_attractionvideo_arcadevineyard *visitor_centerwater_parkwedding_venuewildlife_parkwildlife_refugezoo
|
| امکانات | ||
public_bathpublic_bathroomstable
|
||
| امور مالی | ||
accountingatmbank
|
||
| غذا و نوشیدنی | ||
acai_shopafghani_restaurantafrican_restaurantamerican_restaurantargentinian_restaurant *asian_fusion_restaurant *asian_restaurantaustralian_restaurant *austrian_restaurant *bagel_shopbakerybangladeshi_restaurant *barbar_and_grillbarbecue_restaurantbasque_restaurant *bavarian_restaurant *beer_garden *belgian_restaurant *bistro *brazilian_restaurantbreakfast_restaurantbrewery *brewpub *british_restaurant *brunch_restaurantbuffet_restaurantburmese_restaurant *burrito_restaurant *cafecafeteriacajun_restaurant *cake_shop *californian_restaurant *cambodian_restaurant *candy_storecantonese_restaurant *caribbean_restaurant *cat_cafechicken_restaurant *chicken_wings_restaurant *chilean_restaurant *chinese_noodle_restaurant *chinese_restaurantchocolate_factorychocolate_shopcocktail_bar *coffee_roastery *coffee_shopcoffee_stand *colombian_restaurant *confectionerycroatian_restaurant *cuban_restaurant *czech_restaurant *danish_restaurant *deli |
dessert_restaurantdessert_shopdim_sum_restaurant *dinerdog_cafedonut_shopdumpling_restaurant *dutch_restaurant *eastern_european_restaurant *ethiopian_restaurant *european_restaurant *falafel_restaurant *family_restaurant *fast_food_restaurantfilipino_restaurant *fine_dining_restaurantfish_and_chips_restaurant *fondue_restaurant *food_courtfrench_restaurantfusion_restaurant *gastropub *german_restaurant *greek_restaurantgyro_restaurant *halal_restaurant* hamburger_restauranthawaiian_restaurant *hookah_bar *hot_dog_restaurant *hot_dog_stand *hot_pot_restaurant *hungarian_restaurant *ice_cream_shopindian_restaurantindonesian_restaurantirish_pub *irish_restaurant *israeli_restaurant *italian_restaurantjapanese_curry_restaurant *japanese_izakaya_restaurant *japanese_restaurantjuice_shopkebab_shop *korean_barbecue_restaurant *korean_restaurantlatin_american_restaurant *lebanese_restaurantlounge_bar *malaysian_restaurant *meal_deliverymeal_takeawaymediterranean_restaurantmexican_restaurantmiddle_eastern_restaurantmongolian_barbecue_restaurant * |
moroccan_restaurant *noodle_shop *north_indian_restaurant *oyster_bar_restaurant *pakistani_restaurant *pastry_shop *persian_restaurant *peruvian_restaurant *pizza_delivery *pizza_restaurantpolish_restaurant *portuguese_restaurant *pubramen_restaurantrestaurantromanian_restaurant *russian_restaurant *salad_shop *sandwich_shopscandinavian_restaurant *seafood_restaurantshawarma_restaurant *snack_bar *soul_food_restaurant *soup_restaurant *south_american_restaurant *south_indian_restaurant *southwestern_us_restaurant *spanish_restaurantsports_bar *sri_lankan_restaurant *steak_housesushi_restaurantswiss_restaurant *taco_restaurant *taiwanese_restaurant *tapas_restaurant *tea_housetex_mex_restaurant *thai_restauranttibetan_restaurant *tonkatsu_restaurant *turkish_restaurantukrainian_restaurant *vegan_restaurantvegetarian_restaurantvietnamese_restaurantwestern_restaurant *wine_barwinery *yakiniku_restaurant *yakitori_restaurant * |
| مناطق جغرافیایی | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| دولتی | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station (فقط ژاپن)policepost_office
|
|
| بهداشت و سلامت | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| محل اقامت | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| اقامتگاه | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| ویژگیهای طبیعی | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| مکانهای عبادت | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| خدمات | ||
aircraft_rental_service *association_or_organization *astrologerbarber_shopbeauticianbeauty_salonbody_art_servicecatering_servicecemeterychauffeur_service *child_care_agencyconsultantcourier_serviceelectricianemployment_agency *floristfood_deliveryfoot_carefuneral_homehair_carehair_saloninsurance_agencylaundrylawyerlocksmith |
makeup_artistmarketing_consultant *moving_companynail_salonnon_profit_organization *painterpet_boarding_service *pet_care *plumberpsychicreal_estate_agencyroofing_contractorservice *shipping_service *storagesummer_camp_organizertailortelecommunications_service_providertour_agencytourist_information_centertravel_agencyveterinary_care
|
|
| خرید | ||
asian_grocery_storeauto_parts_storebicycle_storebook_storebuilding_materials_store *butcher_shopcell_phone_storeclothing_storeconvenience_storecosmetics_store *department_storediscount_storediscount_supermarket *electronics_storefarmers_market *flea_market *food_storefurniture_storegarden_center *general_store *gift_shopgrocery_storehardware_storehealth_food_store *home_goods_store
|
home_improvement_storehypermarket *jewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storesportswear_store *storesupermarkettea_store *thrift_store *toy_store *warehouse_storewholesalerwomens_clothing_store * |
|
| ورزشگاهها | ||
arenaathletic_fieldfishing_charterfishing_pier *fishing_pondfitness_centergolf_coursegymice_skating_rinkindoor_golf_course * |
playgroundrace_course *ski_resortsports_activity_locationsports_clubsports_coachingsports_complexsports_school *stadiumswimming_pool *tennis_court * |
|
| حملونقل | ||
airportairstripbike_sharing_station *bridge *bus_stationbus_stopferry_service *ferry_terminalheliportinternational_airportlight_rail_stationpark_and_ride |
subway_stationtaxi_service *taxi_standtoll_station *train_stationtrain_ticket_office *tram_stop *transit_depottransit_stationtransit_stop *transportation_service *truck_stop
|
|
جدول ب
مقادیر نوع «مکان» در جدول B ممکن است بهعنوان بخشی از پاسخ «جزئیات مکان» (جدید)،
«جستجوی اطراف» (جدید)،
«جستجوی نوشتار» (جدید)، یا
«تکمیل خودکار» (جدید) برگردانده شود. این نوعها همچنین توسط includedPrimaryTypes برای درخواستهای «تکمیل خودکار» (جدید) پشتیبانی میشوند.
| مقادیر نوع مکان اضافی | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code
|
point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_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 |
مرجع مکان کدگذاریشده، برگرفته از عرض جغرافیایی و طول جغرافیایی. در جاهایی که نشانی خیابان وجود ندارد (ساختمانها شماره ندارند یا خیابانها نام ندارند)، میتوان از 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 |
مکان ایستگاه اتوبوس، قطار، یا حملونقل عمومی. |