مقدمة
تتوافق Places API مع تفاصيل المكان (الإصدار القديم). إذا كنت على دراية بواجهة برمجة التطبيقات Places API (الإصدار القديم)، تُجري تفاصيل المكان (الإصدار الجديد) التغييرات التالية:
- يجب استخدام قناع الحقل. يجب تحديد الحقول التي تريد عرضها في الردّ. لا توجد قائمة تلقائية بالحقول المعروضة. إذا لم تُدرِج هذه القائمة، ستعرض الطرق خطأً. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تتوافق تفاصيل المكان (الإصدار الجديد) مع كل من مفاتيح واجهة برمجة التطبيقات وOAuth كآلية للمصادقة.
- لا يتم تنسيق الردّ في تفاصيل المكان (الإصدار الجديد) إلا بتنسيق JSON.
- تغيّر تنسيق الردّ بتنسيق JSON في Places API (الإصدار الجديد) عن تنسيق واجهات برمجة التطبيقات القديمة. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة نقل الردّ في 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 الخاص بالردّ.