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

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

مقدمة

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

  • يجب إخفاء الحقول. يجب تحديد الحقول التي تريد عرضها في الردّ. لا تتوفّر قائمة تلقائية بالحقول التي يتم عرضها. في حال حذف هذه القائمة، ستعرض الطرق خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
  • تتيح واجهة تفاصيل المكان (الجديدة) استخدام كلّ من مفاتيح واجهة برمجة التطبيقات ورموز OAuth المميّزة كآلية مصادقة.
  • يتم دعم JSON فقط كتنسيق استجابة في تفاصيل المكان (جديد).
  • تغيّر تنسيق استجابة JSON في Places API (الإصدار الجديد) عن تنسيق واجهات برمجة التطبيقات القديمة. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل الردّ من Places API.

يعرض الجدول التالي المَعلمات في Place Details (الإصدار القديم) التي تمت إعادة تسميتها أو تعديلها في Place Details (الإصدار الجديد)، أو المَعلمات التي لم تعُد متاحة.

المَعلمة الحالية معلَمة جديدة ملاحظات
place_id places/PLACE_ID تُعرف السلسلة places/PLACE_ID أيضًا باسم اسم مورد المكان. في الردّ على طلبات "تفاصيل المكان (الجديدة)" و"البحث في الجوار (الجديد)" و"البحث النصي (الجديد)"، يتم تضمين هذه السلسلة في الحقل name من الردّ. يتم تضمين رقم تعريف المكان المستقل في الحقل id من الاستجابة.
language languageCode
region regionCode

مثال على الطلب

يستخدم مثال طلب استرداد بيانات باستخدام GET التالي واجهة برمجة التطبيقات تفاصيل المكان (القديمة). في هذا المثال، تطلب ردّ JSON يحتوي على معلومات عن رقم تعريف مكان وتمرّر جميع المَعلمات كمَعلمات عنوان URL. يستخدم هذا المثال أيضًا fields لكي يتضمّن الردّ الاسم المعروض والعنوان المنسَّق للمكان فقط:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'

باستخدام تفاصيل المكان (جديد)، يمكنك إرسال طلب استرداد بيانات باستخدام GET وتمرير جميع المَعلمات في مَعلمات عناوين URL والرؤوس كجزء من الطلب. يستخدم هذا المثال أيضًا قناع حقل لكي يتضمّن الردّ الاسم المعروض والعنوان المنسَّق للمكان فقط:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,formattedAddress" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

تُعرف السلسلة places/PLACE_ID أيضًا باسم اسم مورد المكان. في الردّ الوارد من طلب "تفاصيل المكان (جديد)" و"البحث في الجوار (جديد)" و"البحث النصي (جديد)"، يتم تضمين هذه السلسلة في الحقل name من الردّ. يتم تضمين رقم تعريف المكان المستقل في الحقل id من الاستجابة.