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

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

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

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

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

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

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

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

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

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

البحث باستخدام نص (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة)

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

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

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

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

  • بحث في الجوار (ميزة جديدة)

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

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

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

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

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

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

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

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

الحقول

تتضمّن 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 الجديدة

إذا كنت من عملاء Places API الحاليين وأردت نقل بيانات تطبيقك لبدء استخدام واجهات برمجة التطبيقات الجديدة، يمكنك الاطّلاع على مستندات نقل البيانات التالية: