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

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

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

يسرد الجدول التالي المَعلمات في واجهات برمجة التطبيقات القديمة للإكمال التلقائي وإكمال طلبات البحث التي تمت إعادة تسميتها أو تعديلها لواجهة برمجة التطبيقات "الإكمال التلقائي (جديد)"، أو المَعلمات التي لم تعُد متاحة.

المَعلمة الحالية معلَمة جديدة ملاحظات
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

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