أنواع الأماكن

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

أنواع الأماكن هي فئات تحدّد خصائص مكان معيّن. يمكن أن يتمّ إسناد نوع مكان واحد أو أكثر إلى مكان معيّن.

يتم تضمين أنواع الأماكن في الردّ من طلب تفاصيل الأماكن (ميزة جديدة)، البحث في الأماكن القريبة (ميزة جديدة)، والبحث النصي (ميزة جديدة)، وإكمال الأماكن تلقائيًا (ميزة جديدة):

• يمكن أن يكون للمكان نوع أساسي واحد من النوع الجدول "أ" أو النوع الجدول "ب" المرتبط به. على سبيل المثال، قد يكون النوع الأساسي هو mexican_restaurant أو steak_house.
• يمكن أن يتضمّن المكان قيم أنواع متعددة من النوع الجدول "أ" أو النوع الجدول "ب" المرتبط به. على سبيل المثال، قد يكون لدى المطعم الأنواع التالية: seafood_restaurant وrestaurant وfood، point_of_interest وestablishment.
• يمكن وضع علامات على العنوان ومكوناته في مكان معيّن بأنواع معيّنة من جدول أنواع العناوين وأنواع مكونات العناوين. على سبيل المثال، قد يتم وضع علامة على عنوان على أنّه street_address وقد يتم وضع علامة على أحد مكوّنات العنوان على أنّه street_number.

يمكنك أيضًا تحديد أنواع الأماكن كجزء من طلب. عند تحديد النوع في الطلب، يعمل كفلتر لحصر الاستجابة على تضمين الأماكن التي تتطابق مع الأنواع المحدّدة فقط.

لمحة عن جداول الأنواع

يسرد الجدول "أ" القيم المسموح بها لأنواع الأماكن:

• كجزء من ردّ من "تفاصيل المكان" (ميزة جديدة)، "البحث في الأماكن القريبة" (ميزة جديدة)، و"البحث النصي" (ميزة جديدة). بعد ذلك، يتم استخدام قيم في الجدول "أ" لتعبئة هذه الحقول.
• كجزء من طلب "البحث عن الأماكن القريبة" (جديد)، يتم استخدامه كقيمة للمعلَمة includedTypes وexcludedTypes includedPrimaryTypes وexcludedPrimaryTypes بعد ذلك، يتم استخدام القيم في الجدول "ب" لتعبئة هذه الحقول.
• كجزء من طلب "بحث نصي (جديد)"، يتم استخدامه كقيمة للمَعلمة includedType.
• كجزء من طلب تطبيق مصغّر لإكمال الأماكن تلقائيًا (جديد)، استخدِم القيم التالية للمَعلمة includedPrimaryTypes.
• كجزء من ردّ أداة "الإكمال التلقائي للأماكن" (جديد).

يسرد الجدول "ب" قيمًا إضافية لأنواع الأماكن والتي قد يتم عرضها أيضًا كجزء من ردّ "تفاصيل المكان" (جديد) و"البحث في الأماكن القريبة" (جديد) و"البحث النصي" (جديد) و"شريحة معلومات إكمال الأماكن تلقائيًا" (جديد). يجب أن يحدِّد الطلب حقلًا واحدًا على الأقل من الحقلين places.types أو places.primaryType في قناع الحقل. لا يجوز استخدام القيم من الجدول "ب" كجزء من طلب، إلا كقيم للمَعلمة includedPrimaryTypes لطلب تطبيق مصغّر لإكمال الأماكن تلقائيًا (جديد).

أنواع العناوين وأنواع مكونات العناوين: تُدرِج هذه السمة الأنواع التي قد تظهر في صفيفَي نوع العنوان ونوع مكوّنات العنوان أو كليهما في محتوى الاستجابة. تخضع أنواع مكوّنات العنوان للتغيير.

الجدول "أ"

ملاحظة: تمّت إضافة الأنواع التي تحمل علامة النجمة (*) كجزء من الإصدار في 7 تشرين الثاني (نوفمبر) 2024.

السيارات الأعمال الثقافة التعليم الترفيه والنشاطات الترفيهية المرافق * الإدارة المالية الأطعمة والمشروبات المناطق الجغرافية الحكومة

الصحة والعافية الإسكان * أماكن الإقامة العناصر الطبيعية * أماكن العبادة خدمات التسوّق رياضة وسائل النقل

سيارات
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
Shopping
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

الجدول "ب"

قيم إضافية لأنواع الأماكن
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 في فئة google.maps.places.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 Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). يُرجى الانتقال إلى 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	الموقع الجغرافي لمحطة حافلة أو قطار أو محطة وسائل نقل عام