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

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

مقدمة

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

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

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

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

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

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

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

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

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

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

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

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