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

مقدمة

تتوافق 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

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