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

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

مقدمة

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

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

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

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

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

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

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

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

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

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

تتضمّن واجهة Places API (الجديدة) واجهتَي بحث:

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

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

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

  • Nearby Search (New)

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

    حدِّد نوعًا واحدًا أو أكثر من أنواع الأماكن التي تحدّد خصائص المكان. على سبيل المثال، حدِّد "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 الاسم المعروض للنوع الأساسي، مترجَم إلى لغة الطلب إذا كان ذلك منطبقًا للاطّلاع على القائمة الكاملة للقيم المحتملة، راجِع الأنواع المتوافقة.
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 (القديمة) الحاليين وتريد نقل تطبيقك لاستخدام Places API (الجديدة)، يُرجى الاطّلاع على مستندات نقل البيانات التالية: