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

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

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