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

تعرض هذه الصفحة القيم المسموح بها للسمة types.

• يسرد الجدول 1 الأنواع المتاحة لعمليات البحث عن الأماكن، ويمكن عرضه مع نتائج تفاصيل المكان، وكجزء من عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي".
• يسرد الجدول 2 الأنواع الإضافية التي يمكن عرضها مع نتائج "تفاصيل المكان"، وكجزء من نتائج الإكمال التلقائي لعبارات البحث المقترحة.
• يسرد الجدول 3 أنواع القوائم التي يمكنك استخدامها في طلبات الإكمال التلقائي.

الجدول 1: أنواع الأماكن

تُستخدم قيم نوع المكان في الجدول 1 بالطرق التالية:

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

الجدول 2: الأنواع الإضافية التي تعرضها خدمة "الأماكن"

تُستخدم قيم نوع المكان في الجدول 2 بالطرق التالية:

• كجزء من طلب تفاصيل المكان (على سبيل المثال، الاتصال بـ fetchPlace())، أو أي مكان يتم فيه عرض نتيجة مكان. ويجب أن يحدد الطلب حقل البيانات المناسب "للأنواع".
• كجزء من عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" لمزيد من المعلومات حول قواعد استخدام هذه القيم، راجِع الإكمال التلقائي للأماكن.
• للإشارة إلى المكونات.

لمزيد من التفاصيل حول هذه الأنواع، يمكنك مراجعة أنواع العناوين.

الجدول 3: أنواع المجموعات المتوافقة في طلبات وضع الإكمال التلقائي

استخدم قيم نوع المكان في الجدول 3، أو القيم في الجدول 1 والجدول 2، كجزء من طلب الإكمال التلقائي للمكان لتقييد النتائج إلى نوع معين.

يُسمح بنوع واحد فقط من الجدول 3 في الطلب. إذا حددت قيمة من الجدول 3، فلا يمكنك تحديد قيمة من الجدول 1 أو الجدول 2.

لمزيد من المعلومات عن قواعد استخدام هذه القيم، راجِع الإكمال التلقائي للأماكن.

الأنواع المتوافقة هي:

• يرشد geocode خدمة "الإكمال التلقائي" لـ "المكان" لعرض نتائج الترميز الجغرافي فقط، بدلاً من نتائج النشاط التجاري. وبشكل عام، يمكنك استخدام هذا الطلب لتحديد النتائج التي قد يكون الموقع الجغرافي المحدَّد فيها غير واضح.
• يطلب address من خدمة "الإكمال التلقائي" لـ "المكان" عرض نتائج الترميز الجغرافي فقط التي تتضمن عنوان دقيق. وبشكل عام، يمكنك استخدام هذا الطلب عندما تعرف أنّ المستخدم سيبحث عن عنوان محدّد بالكامل.
• يوجه establishment خدمة "الإكمال التلقائي" لـ "المكان" لعرض نتائج النشاط التجاري فقط.
• تطلب مجموعة الأنواع (regions) من خدمة "الأماكن" عرض أي نتيجة تطابق الأنواع التالية:
  • locality
  • sublocality
  • postal_code
  • country
  • administrative_area_level_1
  • administrative_area_level_2
• تطلب مجموعة الأنواع (cities) من خدمة "الأماكن" عرض النتائج التي تطابق locality أو administrative_area_level_3.