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

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

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

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

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