أنواع الأماكن (جديدة)

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

يتم تضمين أنواع الأماكن في الردّ من طلبات Place Details (New) وNearby Search (New) وText Search (New) وAutocomplete (New):

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

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

يجب تفعيل Places API (الإصدار الجديد) في مشروعك على Google Cloud للوصول إلى هذه الأنواع. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.

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

تدرج الجدول أ الأنواع المستخدَمة بالطرق التالية:

• كجزء من الردّ الوارد من Place Details (New) وNearby Search (New) وText Search (New)، يتم استخدام القيم الواردة في الجدول (أ) لتعبئة السمة types الخاصة بعنصر GMSPlace. يجب أن يحدّد الطلب GMSPlacePropertyTypes في قائمة الحقول.
• كجزء من طلب "البحث القريب" (جديد)، يتم استخدامه كقيمة للمَعلمات "الأنواع المضمّنة" و"الأنواع المستبعَدة" و"الأنواع الأساسية المضمّنة" و"الأنواع الأساسية المستبعَدة".
• كجزء من طلب "البحث النصي (جديد)"، يتم استخدامها كقيمة لمعلَمة النوع المضمّنة.
• كجزء من طلب Place Autocomplete (New)، استخدِم القيم الخاصة بمَعلمة types.
• كجزء من استجابة ميزة "الإكمال التلقائي للأماكن (جديدة)"، تُستخدَم لتعبئة السمة types الخاصة بالكائن GMSAutocompletePlaceSuggestion.

يسرد الجدول ب قيمًا إضافية لأنواع الأماكن يمكن عرضها أيضًا كجزء من الردود التي تقدّمها واجهات برمجة التطبيقات Place Details (جديدة) وNearby Search (جديدة) وText Search (جديدة) وPlace Autocomplete (جديدة). يجب أن يحدّد الطلب GMSPlacePropertyTypes في قائمة الحقول. لا يجوز استخدام القيم من الجدول (ب) كجزء من الطلب، باستثناء القيم الخاصة بمَعلمة الأنواع في طلب Place Autocomplete (New).

تدرج أنواع العناوين وأنواع عناصر العناوين الأنواع التي قد تظهر في مصفوفات أنواع العناوين أو أنواع عناصر العناوين أو كليهما في نص الاستجابة. تخضع أنواع عناصر العناوين للتغيير.

الجدول (أ)

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

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

سيارات
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
تسوّق
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

يمكن عرض قيم نوع المكان في الجدول (ب) كجزء من استجابة Place Details (New) أو Nearby Search (New) أو Text Search (New) أو Autocomplete (New). تتوافق هذه الأنواع أيضًا مع طلبات 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 في الفئة GMSPlace ضمن الرد إلى نوع العنوان. تشمل أمثلة أنواع العناوين عنوان شارع أو بلدًا أو كيانًا سياسيًا. تشير مصفوفة types في عنصر GMSAddressComponent إلى نوع كل جزء من العنوان. وتشمل الأمثلة رقم الشارع أو البلد.

قد تتضمّن العناوين أنواعًا متعددة. يمكن اعتبار الأنواع "علامات". على سبيل المثال، يتم تصنيف العديد من المدن باستخدام النوعَين political وlocality.

تتوفّر الأنواع التالية ويتم عرضها في كل من مصفوفة نوع العنوان ومصفوفة نوع عنصر العنوان:

نوع العنوان	الوصف
street_address	تمثّل هذه السمة عنوان الشارع الدقيق.
route	طريق مسمّى (مثل "الطريق السريع 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	موقع محطة حافلات أو قطارات أو وسائل نقل عام