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

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

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

يسرد الجدول التالي المَعلمات في ميزة "تفاصيل الأماكن" الحالية التي تمت إعادة تسميتها أو تعديلها لميزة "تفاصيل الأماكن" الجديدة، أو المَعلمات التي لم تعُد متاحة.

المَعلمة الحالية معلَمة جديدة ملاحظات
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 في الاستجابة رقم تعريف المكان المستقل.