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

المطوّرون في المنطقة الاقتصادية الأوروبية

مقدمة

تتيح 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 واجهة برمجة التطبيقات Place Details (القديمة). في هذا المثال، تطلب استجابة 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 في الاستجابة رقم تعريف المكان المستقل.