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

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

مقدمة

تتيح 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

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