نقل أتمتة Zapier أو Make إلى مضيف ترميز جغرافي جديد
تحتاج عمليات الأتمتة دون شيفرة المبنية على خطوة ترميز جغرافي إلى نهج ترحيل مختلف عن الشيفرة المخصصة. إليك كيفية التعامل مع هذا التحويل.
الانتقال من تكامل الإكمال التلقائي في Google Places
الإكمال التلقائي نوع مختلف من التكامل عن استدعاء ترميز جغرافي منفرد. فهو يُطلق مع كل ضغطة مفتاح تقريبًا يقوم بها المستخدم في حقل العنوان، ويعتمد لدى بعض المزودين على تسعير أو تجميع قائم على الجلسات، ويجب أن تعود الاستجابة بسرعة كافية لأن أي تأخير يكون ملحوظًا بوضوح لمن يكتب. وترحيل هذا الجزء يحمل مخاطر على تجربة المستخدم أكثر من مهمة ترميز جغرافي مجمّعة تحديدًا لأن المستخدمين يتفاعلون معه مباشرة وفي الوقت الفعلي.
يُرجع Google Places Autocomplete قائمة من التوقعات، لكل منها نص description ومعرّف place_id يُستخدم في استدعاء تفاصيل لاحق لجلب معلومات العنوان الكامل والإحداثيات. وهذا النمط ذو الخطوتين، التوقعات أولًا ثم التفاصيل، نموذج تفاعل محدد يشكّل كثيرًا من كود الواجهة الأمامية المبني حوله، بما في ذلك توقيت التأخير (debounce) وطريقة عرض النتائج المختارة قبل اكتمال استدعاء التفاصيل.
هذه حالة يهم فيها وصف القدرات بصدق. توفر My Geocode الإكمال التلقائي للعناوين كجزء من نقاط نهاية الاستعلام الخاصة بها، مع طلب واستجابة بالشكل الموثق في /docs/address-autocomplete/، لكن السلوك المحدد لأي نقطة نهاية للإكمال التلقائي، بما في ذلك تجميع الجلسات وترتيب النتائج، يستحق الاختبار مباشرة مقابل بيانات العناوين وأنماط المستخدمين لديك بدلًا من افتراض تطابق تام مع نموذج Google ذي الخطوتين. فالمزودون المختلفون يبنون مسار الانتقال من الاقتراح إلى التفاصيل بطرق مختلفة، وهذا الاختلاف البنيوي هو عادةً أكبر مهمة ترحيل فعلية هنا، أكثر من أي اسم حقل منفرد.
خطوات عملية لهذا الترحيل:
- حدد ما إذا كان تطبيقك الحالي يحتاج إلى نمط الخطوتين (التوقعات ثم التفاصيل)، أو ما إذا كانت نقطة نهاية للاقتراحات باستدعاء واحد ستبسّط كود الواجهة الأمامية لديك فعلًا
- اختبر إعدادات التأخير (debounce) والحد الأدنى لعدد الأحرف مقابل أزمنة الاستجابة الحقيقية لنقطة النهاية الجديدة في ظروف شبكتك، بدلًا من إعادة استخدام قيم مضبوطة على البنية التحتية لدى Google
- تحقق من كيفية تعامل واجهتك مع قائمة توقعات تعود فارغة أو بنتيجة واحدة فقط، لأن سلوك الترتيب يختلف بشكل ملموس بين المزودين، ولا ينبغي أن تعتمد تجربة المستخدم البديلة لديك على تلقي عدة اقتراحات
تعمل المصادقة في نقطة النهاية الجديدة بمفتاح في ترويسة X-API-Key، أو Authorization: Bearer، أو عبر مصادقة HTTP Basic، أو كمعامل في الاستعلام. وهناك 2,500 طلب مجاني يوميًا دون أي مفتاح على الإطلاق، و2,500 طلب مجاني إضافي لكل مفتاح يوميًا يُحتسب لكل شبكة، وبعد ذلك يكون التسعير رصيدًا مسبق الدفع بسعر 0.0001 € لكل طلب أو مفتاح Unlimited بسعر 50 € شهريًا، بالسعر نفسه لكل نقطة نهاية أخرى.
لأن استدعاءات الإكمال التلقائي قد تكون مرتفعة الحجم مقارنة باستدعاءات الترميز الجغرافي الفعلية، نظرًا لأن معظم ضغطات المفاتيح تولّد طلبًا، فمن المفيد تقدير الحجم اليومي المتوقع مقابل الحصة المجانية والسعر لكل طلب قبل الالتزام بموعد إطلاق، حتى لا تكون هناك مفاجآت في الأسبوع الأول من حركة المرور الحية.