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

المطوّرون في المنطقة الاقتصادية الأوروبية

مقدمة

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

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

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