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

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

مقدمة

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

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

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

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

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

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

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

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

لتضمين اسم مورد الصورة في الردّ من طلب Place Details (New) أو Text Search (New) أو Nearby Search (New)، احرص على تضمين الحقل photos في قناع الحقل الخاص بالطلب.

البحث النصي (جديد) و"البحث في الأماكن القريبة" (جديد)

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

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

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

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

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

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

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

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

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

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

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

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

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

الحقول

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

السمات

تتضمّن 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 (New):

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

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

نقل البيانات إلى واجهات New Places APIs

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