الأخبار

نقطة نهاية جديدة للمعالجة المجمعة لقوائم العناوين

معالجة قائمة عناوين عنوانًا تلو الآخر، باستدعاء HTTP بعد آخر، تعمل جيدًا مع الكميات الصغيرة وتصبح مرهقة بسرعة عند أي حجم حقيقي. أصبحنا ندعم الآن إرسال قائمة عناوين كاملة في استدعاء مجمع واحد، مما يقلل عدد الرحلات ذهابًا وإيابًا اللازمة لمعالجة قائمة كبيرة دون تغيير طريقة تسعير أي شيء.

قاعدة الاحتساب هنا هي بالضبط القاعدة التي نطبقها في كل مكان آخر على المنصة: كل عنوان داخل الاستدعاء المجمع يُحتسب طلبًا واحدًا، وليس الاستدعاء بأكمله. أرسل قائمة من خمسمئة عنوان في استدعاء مجمع واحد، وسيستهلك ذلك خمسمئة طلب من الحصة المطبقة أيًا كانت، سواء كانت الحصة اليومية المجانية أو الرصيد مسبق الدفع بسعر 0.0001 € للطلب أو التغطية ضمن باقة Unlimited. لا يوجد خصم ولا غرامة على دمج العمل في استدعاء واحد مقارنة بإرساله في استدعاءات أصغر كثيرة.

تعكس ترويسات الحصة الاستدعاء المجمع بدقة أيضًا. فكل من X-Quota-Used وX-Quota-Free-Remaining وX-Credits-Remaining يتغير بعدد العناوين التي عولجت فعليًا في الاستدعاء، لذا يحدّث الطلب المجمع الكبير حصتك المرئية بالطريقة نفسها التي كانت ستحدّثها بها خمسمئة استدعاء فردي، لكن في رحلة واحدة ذهابًا وإيابًا بدلًا من خمسمئة.

يستهدف هذا تحديدًا نوع العمل الذي كان يعني سابقًا كتابة حلقة تكرار حول استدعاءات العنوان الواحد: استيراد قائمة عملاء تحتاج إلى ترميز جغرافي، أو تنظيف قاعدة بيانات عناوين، أو تجهيز مهمة مجمعة كبيرة تعمل وفق جدول زمني بدلًا من الاستجابة لإجراء واحد من مستخدم. وإرسال تلك القائمة في استدعاء مجمع واحد يقلل عبء إدارة اتصالات HTTP منفصلة كثيرة، وهو مفيد بشكل خاص للمهام التي تعمل على بنية تحتية لها قيود خاصة بها على الاتصالات أو المعدل تتجاوز قيودنا.

لم تتغير المصادقة ولا السلوك العام: تعمل طرق المفاتيح الأربع نفسها، وتنطبق قواعد الحصة نفسها، وتغطي الحصة المجانية نفسها اختبارًا حقيقيًا قبل أن تترتب أي تكلفة فعلية. وكما هو الحال مع أي استعلام قائم على العناوين، لا تزال نتائج الترميز الجغرافي الأمامي والعكسي جزءًا من الخادم الخلفي الذي نطوره حاليًا لتقديم نتائج حقيقية كاملة، لذا فإن هذه القدرة المجمعة موثقة تحديدًا من حيث شكل الطلب وسلوك الاحتساب.

التوثيق الكامل لإرسال الطلبات المجمعة، بما في ذلك تنسيق الطلب، متاح في /docs/forward-geocoding/ و/docs/reverse-geocoding/. إذا كان سير عملك يمر حاليًا في حلقة على استدعاءات العنوان الواحد، فهذا يستحق النظر لأي عملية تعالج أكثر من بضعة عناوين في المرة الواحدة.