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

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

مقدمة

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

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

يسرد الجدول التالي المَعلمات في الإكمال التلقائي للأماكن (الإصدار القديم) و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'

باستخدام Autocomplete (الإصدار الجديد)، يتم تقديم طلب POST وتمرير جميع المَعلمات في نص طلب JSON أو في العناوين كجزء من طلب POST.

لا تكون أقنعة الحقول مطلوبة لطلبات Autocomplete (الإصدار الجديد)، ولكن يمكن استخدامها لفلترة نتائج معيّنة في الاستجابة. على سبيل المثال، يستخدم الطلب التالي قناع حقل لكي لا تتضمّن الاستجابة سوى 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

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