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