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

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

• يستخدم خيار "الإكمال التلقائي (جديد)" طلبات 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

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