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

تتيح Places API الحالية تفاصيل المكان إذا كنت على دراية بـ Places API الحالية، النسخة الجديدة من "تفاصيل المكان" بإجراء التغييرات التالية:

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