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

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

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

واجهة برمجة التطبيقات لتفاصيل المكان

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

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

واجهة برمجة تطبيقات صور المكان

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

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

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

"البحث النصي" و"البحث عن قرب"

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات الإكمال التلقائي والرموز المميزة للجلسة

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

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

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

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

الحقول

تتضمن Places API (الجديدة) عدة حقول جديدة:

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