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

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

مقدمة

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

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

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

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

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

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

Place Photos (New) lets you add high quality photographic content to your application by giving you access to the millions of photos stored in the Google Places database. باستخدام واجهة Place Photos (New) API، يمكنك الوصول إلى الصور وتغيير حجمها إلى الحجم الأمثل لتطبيقك.

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

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

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

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

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

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

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

  • Nearby Search (New)

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

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

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

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

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

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

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

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

الحقول

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

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

نقل البيانات إلى Places API (جديدة)

إذا كنت من عملاء Places API (الإصدار القديم) وتريد نقل تطبيقك إلى Places API (الإصدار الجديد)، يُرجى الاطّلاع على مستندات نقل البيانات التالية: