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