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

المطوّرون المقيمون في المنطقة الاقتصادية الأوروبية (EEA)

مقدمة

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

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

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

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

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

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

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

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

لتضمين اسم مصدر الصورة في الردّ من طلب "تفاصيل المكان" (جديدة) أو "البحث النصي" (جديدة) أو "بحث في الجوار" (جديدة)، تأكَّد من تضمين حقل 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
  • LPG
  • E80
  • E85
  • الميثان
  • ديزل حيوي
  • ديزل الشاحنات
evChargeOptions عدد شواحن المركبات الكهربائية في هذه المحطة على الرغم من أنّ بعض شواحن المركبات الكهربائية تحتوي على موصلات متعددة، لا يمكن لكل شاحن شحن سوى مركبة واحدة في كل مرة، ونتيجةً لذلك، يعكس هذا الحقل عدد شواحن المركبات الكهربائية المتاحة في وقت معيّن.
shortFormattedAddress عنوان قصير للمكان يمكن لشخص عادي قراءته
primaryType النوع الأساسي للنتيجة المعروضة على سبيل المثال، يمكن تصنيف مكان على أنّه cafe أو airport. لا يمكن أن يكون للمكان سوى نوع أساسي واحد. للاطّلاع على القائمة الكاملة بالقيم الممكنة، يُرجى الاطّلاع على الأنواع المتوافقة.
primaryTypeDisplayName اسم العرض للنوع الأساسي، مترجَمًا إلى لغة الطلب إن أمكن للاطّلاع على القائمة الكاملة بالقيم الممكنة، يُرجى الاطّلاع على الأنواع المتوافقة.
entrances مداخل الوجهة المدخل هو زوج واحد من إحداثيات خطوط الطول والعرض يحدّد موقع نقطة الدخول والخروج لمكان.
navigationPoints نقاط التنقّل للوجهة نقطة التنقّل هي موقع بجانب طريق يمكن أن ينتهي فيه التنقّل، بما في ذلك وسائل النقل والاستخدامات المتاحة.

السمات

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

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

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

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

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

ملخّصات من إنشاء الذكاء الاصطناعي

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

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

الميزات من إنشاء الذكاء الاصطناعي التي تمت إضافتها إلى Places API (جديدة)

تتوفّر الملخّصات من إنشاء الذكاء الاصطناعي في "تفاصيل المكان" (جديدة)، "البحث النصي" (جديدة)، و "بحث في الجوار" (جديدة). تتوفّر الملخّصات التالية من إنشاء الذكاء الاصطناعي في ردود Places API (جديدة):

  • ملخّصات الأماكن، هي ملخّصات قصيرة تقدّم نظرة عامة عن مكان معيّن.
  • ملخّصات المراجعات: هي ملخّصات سهلة القراءة لما قاله المراجعون عن مكان معيّن.
  • ملخّصات المناطق: تقدّم نظرة عامة عن الأماكن القريبة والشائعة في المنطقة المحيطة. وتشمل ملخّصات الأحياء وملخّصات محطات شحن المركبات الكهربائية.

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

نقل البيانات إلى واجهات برمجة التطبيقات الجديدة في Places API

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