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

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

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

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

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

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

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

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

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

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

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

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

  • البحث النصي (جديد)

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

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

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

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

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

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

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

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

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

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

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

الحقول

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

الحقل الوصف
regularSecondaryOpeningHours يشير إلى أوقات معيّنة لعمليات معيّنة. تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدّد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات العمل الثانوية.
paymentOptions خيارات الدفع التي يقبلها المكان ويمكن أن يقبل مكان ما أكثر من خيار دفع واحد. إذا لم تتوفّر بيانات خيار الدفع، سيتم إلغاء ضبط حقل خيار الدفع. وتشمل الخيارات ما يلي:
  • بطاقة ائتمان
  • بطاقة السحب الآلي
  • الدفع النقدي فقط
  • الدفع من خلال الاتصال القصير المدى (NFC)
parkingOptions خيارات وقوف السيارات التي يقدمها المكان. وتشمل الخيارات ما يلي:
  • مواقف سيارات مجانية
  • مواقف سيارات مدفوعة
  • موقف سيارات مجاني في الشارع
  • خدمة ركن السيارات
  • موقف سيارات مجاني في مرآب
  • مرآب سيارات برسوم
subDestinations الأماكن الفريدة المرتبطة بمكان معيّن على سبيل المثال، تُعتبر محطات المطارات وجهات فرعية للمطار.
fuelOptions هي أحدث المعلومات حول خيارات الوقود المتوفّرة في محطات وقود. يتم تعديل هذه المعلومات بشكل منتظم. وتشمل الخيارات ما يلي:
  • ديزل
  • عادي بدون توجيه
  • متوسط
  • مميّزة
  • 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 وتريد نقل بيانات تطبيقك لاستخدام واجهات برمجة التطبيقات الجديدة، يمكنك الاطّلاع على مستندات نقل البيانات التالية: