أنواع الأماكن هي فئات تحدّد خصائص المكان. يمكن أن يكون للمكان نوع واحد أو أكثر من أنواع الأماكن.
يتم تضمين أنواع الأماكن في الردّ على طلبات "تفاصيل المكان (جديد)" و"البحث في الأماكن القريبة (جديد)" و"البحث النصي (جديد)" و"الإكمال التلقائي (جديد)":
- يمكن أن يكون للمكان نوع أساسي واحد من النوع
الجدول (أ) أو النوع الجدول (ب) مرتبطًا به.
على سبيل المثال، قد يكون النوع الأساسي هو
mexican_restaurantأوsteak_house.قد لا يتوفّر النوع الأساسي إذا كان النوع الأساسي للمكان غير متوافق. عند توفّر نوع أساسي، يكون دائمًا أحد الأنواع في الحقلtypes. - يمكن أن يتضمّن المكان قيم أنواع متعددة من النوع
الجدول أ أو النوع الجدول ب المرتبط به.
على سبيل المثال، قد يكون لدى مطعم الأنواع التالية:
seafood_restaurantوrestaurantوfoodوpoint_of_interestوestablishment. - يمكن وضع علامة على العنوان ومكوّنات العنوان لمكان معيّن باستخدام أنواع معيّنة من جدول
أنواع العناوين وأنواع مكوّنات العناوين. على سبيل المثال، قد يتم وضع علامة على عنوان على أنه
street_addressوقد يتم وضع علامة على أحد مكونات العنوان على أنهstreet_number.
يمكنك أيضًا تحديد أنواع الأماكن كجزء من طلب. عند تحديد النوع في الطلب، يعمل النوع كفلتر لحصر الرد على الأماكن التي تتطابق مع الأنواع المحدّدة فقط.
لمحة عن جداول الأنواع
يسرد الجدول "أ" الأنواع التي يتم استخدامها بالطرق التالية:
- كجزء من الردّ الوارد من تفاصيل المكان (جديد) وبحث في الجوار (جديد) والبحث النصي (جديد)، يتم استخدام القيم الواردة في الجدول (أ) لتعبئة سمة الأنواع الخاصة بكائن
Place. يجب أن يحدّد الطلبPlace.Field.TYPESأوPlace.Field.PRIMARY_TYPEفي قائمة الحقول. - كجزء من طلب "بحث في الجوار (جديد)"، يُستخدَم كقيمة لمَعلمات الأنواع المضمّنة والأنواع المستبعَدة والأنواع الأساسية المضمّنة والأنواع الأساسية المستبعَدة.
- كجزء من طلب "البحث النصي (الجديد)"، يُستخدَم كقيمة لمَعلمة النوع المضمّنة.
- كجزء من طلب "الإكمال التلقائي للأماكن (جديد)"، استخدِمها كقيم لمَعلمة الأنواع الأساسية.
- كجزء من استجابة "الإكمال التلقائي للأماكن (جديد)"
المستخدَمة لتعبئة سمة الأنواع في مثيل
AutocompletePrediction.
الجدول ب يسرد قيم أنواع الأماكن الإضافية
التي قد يتم عرضها أيضًا كجزء من استجابة
"تفاصيل المكان (جديد)" و
"البحث في الأماكن القريبة (جديد)" و
"البحث النصي (جديد)" و
"الإكمال التلقائي للأماكن (جديد)". يجب أن يحدّد الطلب Place.Field.TYPES أو Place.Field.PRIMARY_TYPE في قائمة الحقول. لن يتم استخدام القيم من "الجدول ب" كجزء من الطلب، باستثناء القيم الخاصة بمَعلمة الأنواع الأساسية في طلب "الإكمال التلقائي للأماكن (جديد)".
أنواع العناوين وأنواع مكوّنات العناوين: تسرد الأنواع التي قد تظهر في مصفوفات نوع العنوان أو نوع مكوّن العنوان أو كليهما في نص الاستجابة. تخضع أنواع مكوّنات العناوين للتغيير.
الجدول أ
| سيارات | ||
|---|---|---|
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
|
|
الجدول (ب)
يمكن عرض قيم أنواع الأماكن في الجدول "ب" كجزء من استجابة "تفاصيل المكان (جديد)" أو "البحث في الأماكن المجاورة (جديد)" أو "البحث النصي (جديد)" أو "الإكمال التلقائي (جديد)". هذه الأنواع متوافقة أيضًا مع 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
|
|
أنواع العناوين وأنواع مكوّنات العناوين
يشير التعداد 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 |
مرجع موقع جغرافي مشفّر، مشتق من خط العرض وخط الطول يمكن استخدام رموز Plus كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). لمزيد من التفاصيل، يُرجى الانتقال إلى 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 |
الموقع الجغرافي لمحطة حافلات أو قطارات أو وسائل نقل عام |