حول Places API (جديدة)

تشمل واجهة Places API (الجديدة) واجهات برمجة التطبيقات التالية:

يحتوي هذا المستند على نظرة عامة حول واجهات برمجة التطبيقات الجديدة هذه.

تفاصيل المكان (جديد)

يحدِّد رقم تعريف المكان مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". يمكنك استخدام رقم تعريف المكان لطلب تفاصيل عن مكان مؤسسة أو نقطة اهتمام من خلال بدء تفاصيل المكان (جديد) طلبك. يعرض طلب تفاصيل مكان (جديد) معلومات شاملة حول المكان المشار إليه مثل عنوانه الكامل ورقم هاتفه وتقييم المستخدم الزملاء.

هناك العديد من الطرق للحصول على رقم تعريف مكان. يمكنك استخدام:

صورة مكان (ميزة جديدة)

تتيح لك واجهة برمجة تطبيقات صور المكان (الجديدة) إضافة محتوى فوتوغرافي عالي الجودة إلى تطبيقك من خلال منحك إمكانية الدخول إلى ملايين الصور المخزنة في قاعدة بيانات أماكن Google. باستخدام واجهة برمجة تطبيقات صور المكان (الجديدة)، يمكنك الوصول إلى الصور وتغيير حجم الصورة إلى الحجم الأمثل لتطبيقك.

يجب أن تشتمل جميع الطلبات الموجّهة إلى واجهة برمجة تطبيقات "صور المكان" (الجديدة) على اسم مورد للصور. الذي يحدد الصورة المراد عرضها بشكل فريد. يمكنك الحصول على مرجع الصور الاسم باستخدام:

لتضمين اسم مورد الصورة في الردّ من طلب "تفاصيل المكان" (جديد) أو "البحث النصي" (جديد) أو "البحث في الأماكن القريبة" (جديد)، احرص على تضمين حقل photos في قناع الحقل للطلب.

البحث النصي (جديد) والبحث عن قرب (جديد)

تتضمّن Places API واجهتَي برمجة تطبيقات للبحث:

  • البحث عن نص (ميزة جديدة)

    للسماح لك بتحديد سلسلة نصية للبحث عن مكان بشأنها. على سبيل المثال: "طعام نباتي حار في سيدني، أستراليا" أو "مطعم مأكولات بحرية فاخرة بالقرب من بالو ألتو، كاليفورنيا".

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

  • البحث عن الأجهزة المجاورة (جديد)

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

    حدد نوعًا واحدًا أو أكثر من أنواع الأماكن التي تحدد خصائص الْمَكَانْ. على سبيل المثال، حدِّد "pizza_restaurant". و"shopping_mall" إلى البحث عن مطعم بيتزا موجود في مركز تسوق في .

ويكمن الاختلاف الرئيسي بين عمليتي البحث في أن البحث النصي (جديد) يتيح لك تحديد سلسلة بحث عشوائية في حين أن البحث عن قرب (جديد) يتطلب المنطقة التي تريد البحث فيها.

الرموز المميزة للإكمال التلقائي (جديد) والرموز المميزة للجلسات

الإكمال التلقائي (جديد) هي خدمة ويب تعرض عبارات بحث مقترحة تنبؤات طلب البحث استجابةً لطلب HTTP. في الطلب، حدِّد سلسلة بحث ملف شخصي وحدودًا جغرافية تتحكّم في منطقة البحث.

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

حقول وسمات وخيارات تسهيل الاستخدام الجديدة

تتضمّن Places API (الإصدار الجديد) حقولًا وسمات وخيارات تسهيل الاستخدام جديدة لتزويد المستخدمين بمزيد من المعلومات عن مكان معيّن. يتم توضيح هذه الجوانب في الأقسام التالية.

الحقول

واجهة برمجة تطبيقات الأماكن (جديدة) تتضمن عدة حقول جديدة:

الحقل الوصف
regularSecondaryOpeningHours تصف هذه السمة أوقاتًا معينة لعمليات معينة. ثانوي تختلف ساعات العمل عن ساعات العمل الرئيسية للنشاط التجاري. بالنسبة على سبيل المثال، يمكن أن يحدد مطعم ساعات القيادة أو التوصيلات ساعات كساعات ثانوية.
paymentOptions خيارات الدفع التي يقبلها المكان يمكن أن يقبل المكان أكثر من خيار دفع واحد. إذا لم تكن بيانات خيار الدفع متاحة، لن يتم ضبط الحقل لخيار الدفع. تشمل الخيارات ما يلي:
  • بطاقة ائتمان
  • بطاقة السحب الآلي
  • الدفع النقدي فقط
  • الدفع من خلال الاتصال القصير المدى (NFC)
parkingOptions خيارات وقوف السيارات التي يقدمها المكان. تشمل الخيارات ما يلي:
  • مواقف سيارات مجانية
  • مواقف السيارات المدفوعة
  • موقف سيارات مجاني في الشارع
  • خدمة ركن السيارات
  • موقف سيارات مجاني في مرآب
  • مرآب سيارات مدفوع
subDestinations الأماكن الفريدة المرتبطة بمكان معيّن على سبيل المثال، تُعدّ مباني الركّاب في المطار وجهات فرعية لمطار معيّن.
fuelOptions أحدث المعلومات حول خيارات الوقود المتوفرة في محطة وقود جديدة. ويتم تعديل هذه المعلومات بانتظام. تشمل الخيارات ما يلي:
  • ديزل
  • بنزين عادي غير مزوّد بالرصاص
  • متوسط
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • غاز البترول المُسال
  • E80
  • E85
  • الميثان
  • ديزل حيوي
  • شاحنة ديزل
evChargeOptions عدد شواحن المركبات الكهربائية في هذه المحطة على الرغم من أنّ بعض محطات شحن المركبات الكهربائية تتضمّن عدة وصلات، يمكن لكل محطة شحن مركبة واحدة فقط في المرة الواحدة. ونتيجةً لذلك، يعرض هذا الحقل عدد محطات شحن المركبات الكهربائية المتاحة في وقت معيّن.
shortFormattedAddress تمثّل هذه السمة عنوانًا قصيرًا لمكان محدّد ويمكن لشخص عادي قراءته.
primaryType النوع الأساسي للنتيجة المقدمة. على سبيل المثال، قد يختار مكان أن يكون مصنّفًا كـ cafe أو airport. حاسمة مكان يمكن أن يحتوي على نوع أساسي واحد فقط. للحصول على القائمة الكاملة القيم المحتملة، راجِع الأنواع المتوافقة.
primaryTypeDisplayName الاسم المعروض للنوع الأساسي، مترجَمًا إلى لغة الطلب إذا كان ذلك منطبقًا للحصول على القائمة الكاملة بالقيم المحتملة، راجِع الأنواع المتوافقة.

السمات

تتضمّن Places API (الجديدة) عدة سمات جديدة:

السمة الوصف
outdoorSeating يضم الفندق أماكن جلوس في الهواء الطلق.
liveMusic ويقدم المكان عروضًا موسيقية حية.
menuForChildren يقدّم المكان قائمة طعام للأطفال.
servesCocktails يقدّم المكان مشروبات الكوكتيل.
servesDessert يقدّم المكان الحلويات.
servesCoffee يقدّم المكان القهوة.
goodForChildren المكان جيد للأطفال.
allowsDogs يسمح الفندق باصطحاب الكلاب.
restroom يضم المكان دورة مياه.
goodForGroups يستوعب المكان مجموعات.
goodForWatchingSports المكان مناسب لمشاهدة الألعاب الرياضية.

خيارات تسهيل الاستخدام

تتضمّن ‫Places API (الإصدار الجديد) حقول خيارات تسهيل الاستخدام التالية:

الحقل الوصف
wheelchairAccessibleParking يوفّر المكان موقف سيارات مناسبًا لأصحاب الكراسي المتحركة.
wheelchairAccessibleEntrance يتوفّر مدخل مناسب للكراسي المتحركة.
wheelchairAccessibleRestroom يتوفّر في المكان دورة مياه مناسبة لأصحاب الكراسي المتحرّكة.
wheelchairAccessibleSeating يتوفّر في المكان أماكن جلوس مناسبة لأصحاب الكراسي المتحركة.

الانتقال إلى واجهات برمجة تطبيقات الأماكن الجديدة

إذا كنت عميلاً حاليًا في Places API وتريد نقل تطبيقك إلى استخدام واجهات برمجة التطبيقات الجديدة، فراجع وثائق النقل التالية: