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

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

مقدمة

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

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

يسرد الجدول التالي المَعلمات في Place Autocomplete (الإصدار القديم) وQuery Autocomplete (الإصدار القديم) التي تمت إعادة تسميتها أو تعديلها في 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

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