نقل البيانات إلى الإكمال التلقائي (جديد)

مقدمة

تتيح Places API استخدام واجهتَي برمجة التطبيقات الإكمال التلقائي للأماكن (الإصدار القديم) وQuery Autocomplete (الإصدار القديم). إذا كنت على دراية بهاتَين الواجهتَين، يُجري الإكمال التلقائي (الجديد) التغييرات التالية:

• يستخدم الإكمال التلقائي (الجديد) طلبات HTTP POST. يمكنك تمرير المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST. في المقابل، يمكنك تمرير مَعلمات عنوان URL باستخدام طلب استرداد بيانات باستخدام GET في واجهات برمجة التطبيقات القديمة.
• يتيح الإكمال التلقائي (الجديد) استخدام مفاتيح واجهة برمجة التطبيقات ورموز OAuth المميزة كآلية للمصادقة.
• لا يتوفّر في الإكمال التلقائي (الجديد) سوى تنسيق JSON كشكل للاستجابة.

يسرد الجدول التالي المَعلمات في الإكمال التلقائي للأماكن (الإصدار القديم) وQuery Autocomplete (الإصدار القديم) التي تم تغيير اسمها أو تعديلها في الإكمال التلقائي (الجديد)، أو المَعلمات التي لم تعُد متاحة.

المعلَمة الحالية	المعلَمة الجديدة	ملاحظات
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		إذا لم يتم تحديد كل من locationBias وlocationRestriction، تستخدم واجهة برمجة التطبيقات تلقائيًا ميزة التحيز المستند إلى عنوان IP.
offset	inputOffset
radius	locationBias أو locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

مثال على الطلب

يستخدم طلب استرداد بيانات باستخدام GET التالي مثالاً على الإكمال التلقائي للأماكن (الإصدار القديم). في هذا المثال، يتم طلب استجابة JSON تحتوي على معلومات عن الأماكن التي تحمل الاسم "Amoeba" من النوع establishment، ويتم تمرير جميع المَعلمات كمَعلمات عنوان URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

باستخدام الإكمال التلقائي (الجديد)، يتم تقديم طلب POST وتمرير جميع المَعلمات في نص طلب JSON أو في العناوين كجزء من طلب POST.

لا تكون أقنعة الحقول مطلوبة لطلبات الإكمال التلقائي (الجديد)، ولكن يمكن استخدامها لفلترة نتائج معيّنة في الاستجابة. على سبيل المثال، يستخدم الطلب التالي قناع حقل لكي لا تتضمّن الاستجابة سوى suggestions.placePrediction.text للاقتراح:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

لمزيد من المعلومات عن استخدام أقنعة الحقول، يُرجى الاطّلاع على مقالة تفاصيل المكان (الجديد).