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

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

• تستخدم ميزة "الإكمال التلقائي" (الإصدار الجديد) طلبات HTTP POST. نقْل المَعلمات في نص الطلب أو في الرؤوس كجزء من طلب 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

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