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

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

مقدمة

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

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

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

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

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

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

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

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

لتضمين اسم مورد الصورة في الردّ من طلب تفاصيل الأماكن (جديد) أو البحث النصي (جديد) أو البحث في الأماكن القريبة (جديد)، احرص على تضمين الحقل 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
  • غاز البترول المُسال
  • 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 لعرض ملخّصات عن الأماكن والمناطق التي يمكن أن تساعد المستخدمين في تحديد أماكن التوجّه.

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

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

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

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

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

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

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