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

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

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

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

المَعلمة الحالية	معلَمة جديدة	Notes
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 من الردّ.

ملاحظة: في حقل تفاصيل المكان الحالي، تضمّن الحقل name من الرد اسمًا يمكن للإنسان قراءته من المكان. في واجهة برمجة التطبيقات الجديدة، تغيّر اسم هذا الحقل إلى displayName.