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

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

مقدمة

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

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

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

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

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

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

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

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

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

البحث النصي (جديدة) و‫بحث في الجوار (جديدة)

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

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

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

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

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

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

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

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

‫Autocomplete (جديدة) ورموز الجلسات

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

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

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

تتضمّن 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 اسم العرض للنوع الأساسي، مترجَمًا إلى لغة الطلب إن أمكن للاطّلاع على القائمة الكاملة بالقيم الممكنة، يُرجى مراجعة الأنواع المتوافقة.

السمات

تتضمّن 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 (جديدة) وأردت نقل بيانات تطبيقك لاستخدام واجهات برمجة التطبيقات الجديدة، يُرجى الاطّلاع على مستندات نقل البيانات التالية: