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

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

مقدمة

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

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

باستخدام ميزة "الإكمال التلقائي (جديدة)"، يمكنك إرسال طلب 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

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