احصل على ترميز جغرافي على مستوى المؤسسة مجانًا باستخدام واجهة برمجة تطبيقات Positionstack (مراجعة)

لا يجب أن تكون خرائط Google للحصول على قيمة من الترميز الجغرافي. وبفضل Positionstack ، لا تحتاج إلى ميزانية Big Big Technology للقيام بذلك أيضًا. واليوم ، نراجع واجهة برمجة التطبيقات القوية لـ Positionstack ، والتي تهدف إلى جعل الترميز الجغرافي للأمام والعكس على مستوى المؤسسة ميسور التكلفة للغاية وقابل للاستخدام.

Positionstack 101

لذا ، لماذا يجب أن تهتم بقراءة مراجعة أكثر من 2000 كلمة Positionstackوماذا تكسب؟ يبدو الجواب لطيفًا ، لكنه دقيق: ال العالم بأكمله.

فكر للحظة في عدد الأماكن الموجودة على خريطة العالم. الآن ، ضع هذا الرقم في رأسك في كل قطعة بيانات وصفية يحتاج عملك إلى معرفتها عن تلك الأماكن. هذا ما يقدمه Positionstack ، ثم بعض الميزات.

دعونا نلقي نظرة على بعض الإحصائيات السريعة حول Positionstack:

• معالجة مليارات طلبات البحث عن الترميز الجغرافي الفعلية كل ساعة وكل يوم ؛ مع وقت تشغيل بنسبة 100٪ ووقت استجابة أقل من 100 مللي ثانية
• البنية التحتية القائمة على السحابة والقابلة للتطوير بدرجة عالية
• يتم تجميع البيانات في الوقت الفعلي حول كل بلد في العالم في مجموعة بيانات كهفية يتم تحديثها كل بضع ساعات
instagram viewer
• خطط اشتراك موزعة بسخاء وبأسعار تنافسية ؛ بالإضافة إلى حصة شهرية لا مثيل لها من 10000 طلب للمستخدمين مجانًا
• دعم التكامل لجميع لغات البرمجة الرئيسية
• وثائق شاملة وسهلة القراءة كاملة مع مقتطفات التعليمات البرمجية
• فريق رضا العملاء على مستوى عالمي مع خبرة تخدم عملاء مثل Zendesk و Slack و LinkedIn و Lyft و Apple و Amazon

من المؤكد أن Positionstack لديها أصلها قيد الاختيار ، ولكن في حالة عدم اقتناعك بعدد قليل من النقاط ، دعنا نلقي نظرة عميقة على ما يشبه استخدام واجهة برمجة التطبيقات بالفعل.

دليل البدء السريع المكون من 3 خطوات في Positionstack

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

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

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

لوحة معلومات Positionstack الخاصة بك

يضاعف Positionstack من قيمته الأساسية لسهولة الاستخدام ، وهو يوفر لوحة تحكم مبسطة ومرتبة يمكنك من خلالها الوصول إلى كل ما تحتاج إلى معرفته عن واجهة برمجة التطبيقات الخاصة بك. دعنا نلقي نظرة على خيارات الشريط الجانبي:

• لوحة القيادة - ستجد هنا إشعارات (تنبهك عادةً عند تجاوزك حدود استخدام معينة) ، ثم روابط إلى كل من دليل البدء السريع المكون من 3 خطوات وصفحة الوثائق الخاصة بها. هناك أيضًا نظرة عامة على مفتاح واجهة برمجة التطبيقات واشتراكك الحالي وتفاصيل الحساب وطريقة الدفع.
• ترقية / اشتراك - يمكنك تغيير اشتراكك في أي من هذين الخيارين. الترقية في أي وقت ، على الرغم من أنك إذا أردت التبديل بين خطة شهرية أو سنوية في أي من الاتجاهين ، فستحتاج أولاً إلى الرجوع إلى حساب مجاني أولاً ، ثم تحديد الخيار المطلوب. دعم Positionstack على استعداد لمساعدتك إذا كنت بحاجة إلى المساعدة في القيام بذلك.
• الحساب / الدفع - هذه التفسيرات الذاتية ؛ ستسمح لك أي من علامات التبويب بتحديث بيانات الاعتماد الخاصة بك في أي وقت. يجب القول أننا نقدر أنهم لا يدفنون عناصر التحكم الأساسية هذه في واجهة مبهجة ومصممة بشكل مفرط. WYSIWYG.
• استخدام API - من المحتمل أن تكون علامة التبويب التي ستعيد زيارتها كثيرًا ، هنا يمكنك العثور على مقدار حصة الطلب الشهرية التي تناولتها حتى الآن. هناك أيضًا قسم مفيد يعرض إحصائيات استخدامك بمرور الوقت ، حتى تتمكن من تعديل استراتيجيتك وفقًا لذلك.

وثائق API

الآن نصل إلى قلب وروح عرض Positionstack: the وثائق API. ضع في اعتبارك هذه الصفحة دليل المستخدم الذي يذهب إليه ، والذي يفصل كل نقطة نهاية لواجهة برمجة التطبيقات ، ومعلماتها ، ونوع المعلومات التي ستعرضها.

هذه الصفحة مقسمة إلى خمسة أقسام مختلفة. سنستعرض كل منها ، ونقضي بعض الوقت والكلام لتوفير بعض السياق لك لفهم أفضل لما ستجده.

ابدء

هنا ، ستجد وظائف أساسية التي تنطبق على كل طلب تقدمه مع Positionstack. وهذه هي:

• مفتاح API - يشبه مفتاح API جواز السفر الرقمي الذي ستستخدمه للوصول إلى مجموعة بيانات Positionstack. بدونها ، فإن واجهة برمجة التطبيقات عديمة الفائدة لك. إذا كنت تعتقد أنه تم اختراقه ، يمكنك بسهولة تدوير مفتاحك القديم إلى مفتاح جديد.
• التشفير - يتم استخدام تشفير SSL 256 بت في جميع أنحاء الإنترنت ، وهو معيار الصناعة للأمان لسبب وجيه. بينما ستحتاج إلى خطة أساسية أو أفضل لتشفير اتصالات تطبيقك مع خوادم Positionstack ، فإنه يستحق الاستثمار بمفرده. لإثارة التشفير ، ما عليك سوى تغيير HTTP إلى HTTPS في عنوان URL الأساسي لواجهة برمجة التطبيقات. بسيط!
• استرجاع JSON - لن نتطرق إلى الكثير من التفاصيل الفنية حول كيفية عمل ذلك ، ولكن إذا كانت طلبات واجهة برمجة التطبيقات الخاصة بك تتعطل بسبب سياسات المصدر نفسه ، فإنك تستخدم عمليات رد الاتصال JSON للتأثير على الحل. بشكل أساسي ، أنت تطلب بيانات من نص برمجي خارجي ، والذي لا يتورط في مشكلات عبر النطاقات.
• أخطاء API - كما هو الحال مع أي شيء ، في بعض الأحيان ستواجه طلبات واجهة برمجة التطبيقات الخاصة بك أخطاء. يتفهم Positionstack هذا ، وقد دمج في تطبيقه وظيفة الإبلاغ عن الأخطاء لمساعدتك في تحديد الخطأ الذي حدث. ستؤدي حالات فشل طلب واجهة برمجة التطبيقات إلى إرجاع كائن خطأ تلقائيًا بتنسيق JSON ، بالإضافة إلى كائنات فرعية للتعليمات البرمجية والرسالة والسياق لتوفير سياق للخطأ.

نقاط نهاية واجهة برمجة التطبيقات

يوثق هذا القسم وظيفة اللحوم والبطاطس في Positionstack ، أي الترميز الجغرافي للأمام والعكس. إذا لم تكن متأكدًا بنسبة 100٪ من الاختلاف ، ففكر في الترميز الجغرافي على أنه شارع ذو اتجاهين حيث يمكنك الترجمة الأماكن والعناوين المكتوبة باللغة الإنجليزية البسيطة لبيانات الموقع مثل الإحداثيات وعناوين IP و العكس بالعكس.

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

طلبات الترميز الجغرافي إلى الأمام / الخلف

لتقديم طلب أساسي لأي نوع من أنواع الترميز الجغرافي ، ستحتاج إلى إلحاق نقطة النهاية المناسبة (/forward أو /reverse) إلى عنوان URL الأساسي لواجهة برمجة التطبيقات. بعد ذلك ، ستوفر مفتاح الوصول الخاص بك ، ثم قم بإجراء الاستعلام باستخدام إما عنوان موقع Plain-English أو بيانات الموقع المقابلة له - وفويلا! سيبدو شيء مثل هذا:

https://api.positionstack.com/v1/forward? access_key = YOUR_ACCESS_KEY & query = 1600 Pennsylvania Ave NW، Washington DC. 

أو

https://api.positionstack.com/v1/reverse? access_key = YOUR_ACCESS_KEY & query = 40.7638435، -73.9729691. 

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

{"data": {"results": [{"latitude": 38.897675، "longitude": -77.036547، "label": "1600 Pennsylvania Avenue NW، Washington، DC، USA"، "name": "1600 Pennsylvania Avenue NW "،" type ":" address "،" number ":" 1600 "،" street ":" Pennsylvania Avenue NW "،" postal_code ":" 20500 "،" trust ": 1،" region ":" منطقة of Columbia "،" region_code ":" DC "،" Administrative_area ": null،" Neighbourhood ":" White House Grounds "،" country ":" United States "،" country_code ":" US "، "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

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

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

ملاحظة: تُفصّل صفحة وثائق Positionstack بالتفصيل كل معلمة وكائن استجابة ، لذا تأكد من التحقق من ذلك!

طلبات دفعة

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

{"batch": [{"query": "Main Street"، "country": "US"، "region": "Minnesota"}، {"query": "Main Street"، "country": "US"، "region": "Illinois"}، {"query": "Main Street"، "country": "US"، "region": "Missouri"} ] }

البيانات المتقدمة

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

• خرائط قابلة للتضمين - إرجاع كائن map_url المرتبط بنتيجة الترميز الجغرافي ، والتي يمكنك استخدامها لإنشاء تمثيل مرئي جذاب للخريطة على موقعك على الويب أو تطبيقك.
• وحدة البلد - على عكس المعلمات الأخرى التي تعود إلى عدد قليل من كائنات الاستجابة ، وحدة البلد إرجاع مجموعة لا تصدق من البيانات حول بلدك المستفسر. إنها ليست مجرد إحداثيات وعناوين أيضًا ؛ هي العاصمة والعلم والاسم الرسمي والحالة كدولة غير ساحلية (أو لا) والعملات المستخدمة واللغات المنطوقة ورموز الاتصال والمزيد.
• وحدة صن - بشكل مضحك ، تصف وثائق Positionstack ذلك بأنها بيانات "فلكية". لن تحصل على برجك مع هذه المعلمة ، ولكنك سترى بيانات حول وقت شروق الشمس وغروبها ، وفقًا للتسلسل الفلكي والمدني والبحري.
• وحدة المنطقة الزمنية - ألحق timezone_module لإرجاع تعويض GMT لموقع ما في ثوانٍ أو كسلسلة لغة طبيعية.
• وحدة الصندوق المحيط - إذا لم يكن زوج واحد من الإحداثيات س / ص مناسبًا لمهمتك ، فجرّب المربع المحيط الذي يحيط بمنطقة تحتوي على قيم الحد الأدنى والحد الأقصى لخط الطول وخط العرض.

خيارات اضافية

يحتوي Positionstack API على الكثير من البيانات لرميها لك ، ولكن لحسن الحظ يوفر لك ذلك أدوات إضافية لإدارة هذا الكم الهائل من المعلومات.

• حدد حقول الاستجابة - لقد قمنا بتغطية متعمقة لكمية البيانات التي يمكن أن يعرضها Positionstack ، ولكن ضع في اعتبارك أن كل هذه البيانات تأتي بتكلفة. إذا كنت ترغب في الحد من الطلبات الشهرية الخاصة بك ، يمكنك القيام بذلك مع مجالات إلحاق الحقول = results.flag، على سبيل المثال ، سيؤدي API إلى إخراج العلم بلد الاستعلام الخاص بك فقط. يمكنك استدعاء مجالات عدد المرات التي تحتاجها للحصول على مجموعة البيانات المحددة التي تحتاجها.
• حدد تنسيق الإخراج - يقتصر المشتركون المجانيون على تنسيق JSON لنتائج الترميز الجغرافي التي تم إرجاعها. ومع ذلك ، يمكن الدفع للعملاء انتاج بناء على طلباتهم لتحديد JSON أو XML أو GeoJSON حسب الضرورة.

أمثلة التعليمات البرمجية

عندما يقول Positionstack أنهم متواجدون لمساعدتك ، فهذا يعني ذلك. لقد رأينا بالفعل مدى دقة وثائقهم ، لكنهم يتفوقون عليها بسهولة أمثلة التعليمات البرمجية في جميع اللغات التي تدعمها API الخاصة بهم. لن نقوم بنسخ / لصق هذا الرمز هنا ، ولكن كمرجع سريع ، فإن هذه اللغات هي:

• بيثون
• Nodejs
• مسج
• اذهب
• روبي

الإثبات والأداء

عند هذه النقطة ، يجب أن يكون واضحًا أن Positionstack قادر على القيام بالكثير. لكن، مدى هل تفعل هذه الأشياء؟

أولاً ، دعنا نفكر في بعض السياق. Positionstack هي واحدة من أكثر من 20 خدمة مصغرًا لواجهة برمجة التطبيقات في النظام البيئي القائم على السحابة Apilayer. تخدم واجهات برمجة التطبيقات هذه معًا أكثر من مليون عميل B2B من الشركات الناشئة وصولاً إلى المؤسسة. بعض من أبرز عملائها تشمل Amazon و Apple و Slack و LinkedIn والعديد من أسماء الأسر. من الواضح أن لديهم بعض البنية التحتية القوية للتعامل مع هذا الحجم من الطلب.

وفقًا لمزاياها ، فإن Positionstack ترقى إلى مستوى نسبها ، مع وقت تشغيل مذهل بنسبة 100٪ طوال عام 2020 في وقت كتابة هذا التقرير. هذا أكثر إثارة للإعجاب عندما تفكر في API بشكل روتيني يعالج أكثر من مليار عملية بحث عن الترميز الجغرافي يوميًا لكل عميل حوت ، ناهيك عن المجموعة المذهلة من الطلبات المتزامنة الواردة من عملاء SMB المستقرين. والأكثر من ذلك أن هذه الطلبات عادةً ما تحصل على ردود تتراوح بين 10 و 100 مللي ثانية.

في كتابنا ، يعد هذا شيئًا من أعجوبة تكنولوجية ، لا سيما بالنظر إلى مدى سعر هذا SaaS بقوة.

وليس فقط القوة الخام هي التي تجعل Positionstack جذابة للغاية. مجموعة البيانات الخاصة بهم معقدة حقًا ، ويتم الحصول عليها من أسماء موثوقة مثل Nominatim و GeoNames و Pelias و OpenStreetMap. يقوم Positionstack بالتدقيق ، والفلاتر ، وإعادة تجميع هذه الثروة من البيانات عدة مرات في اليوم ، مما يدفع بالتحديثات المنتظمة عبر الخوارزميات الذكية التي تضمن لك دائمًا بيانات موقع دقيقة للغاية ، في أي مكان في العالم ، وفي الواقع زمن.

نحن نكره إفساد حكمنا النهائي ، ولكن إذا كنت تبحث عن حل ترميز جغرافي قوي وقابل للتطوير ، فإن استئناف Positionstack يتطلب نظرة فاحصة.

التسعير

شرعت Apilayer في تقديم بديل ميسور التكلفة لبرامج الترميز الجغرافي على مستوى المؤسسة باهظة الثمن ، وقد نجحت في تحقيق هذه الغاية.

Positionstack يأتي في خمسة التسعير المستويات ، ويدعم الفوترة الشهرية ، أو الاشتراكات السنوية بخصم 20 ٪. هذه المستويات هي:

• مجانا - تم تقييمها للاستخدام الشخصي ، لا تزال تحصل على قدر جيد من الأميال مع 25000 طلبًا شهريًا للترميز الجغرافي للأمام والعكس ، يتم إنتاجه بتنسيق JSON. لا تحصل على الكثير من الميزات المتقدمة أو دعم العملاء ، لكننا أظهرنا لك بالفعل ما هو المورد القيِّم الذي تمثله صفحة وثائقهم. هذه الطبقة مجانية وبدون التزامات - لا يتعين عليك حتى تقديم تفاصيل بطاقة الائتمان للبدء.
• الأساسي - الحزمة التجارية للمبتدئين. يضاعف المشتركون الأساسيون من حصتهم الشهرية أربعة أضعاف إلى 100000 طلب ترميز جغرافي ، بالإضافة إلى الوصول إلى المتقدم ميزات مثل تشفير HTTPS وخيارات إخراج متعددة (JSON و XML و GeoJSON) وخرائط قابلة للتضمين ولغات متعددة ، و اكثر. احصل على ترخيص Positionstack التجاري مقابل 9.99 دولارًا أمريكيًا فقط في الشهر.
• المحترفين - العرض الأكثر شعبية من Positionstack ، يقدم المستوى الاحترافي زيادة بمقدار عشرة أضعاف في طلبات الترميز الجغرافي - حتى 1،000،000 شهريًا. جميع الأشياء الجيدة من المستوى الأساسي موجودة ثم بعضها ، لا سيما بما في ذلك الطلبات المجمعة لتطبيقات الخدمة الشاقة. هذه الطبقة في 49.99 دولارًا في الشهر.
• اعمال - بالانتقال إلى الأداء على مستوى المؤسسة ، فإن طبقة الأعمال تستحوذ على الحصة الشهرية لتصل إلى 3،000،000 طلب. مرة أخرى ، كل ميزة متقدمة متاحة بالكامل ، مدعومة بفريق دعم العملاء المتحمس من Positionstack لمساعدتك في تحقيق أقصى استفادة منها. 99.99 دولارًا في الشهر.
• مشروع - مغامرة - هذا هو المستوى الذي تخرج فيه العروض القياسية من النافذة ، والعميل ملك. لديك احتياجات دقيقة تتطلب حلولًا مخصصة ، و Positionstack جاهز لتحقيق أهدافك. تملي طلبات الحجم الشهرية ، حتى (خاصة) إذا كانت متغيرة. هل تحتاج إلى قوة حصانية أكثر من واجهة برمجة التطبيقات؟ تواصل لدعم الحلول المخصصة. اتصل Positionstack للحصول على عرض أسعار.

الحكم

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

ما نوع التكامل الذي خططت له؟ كيف ستستفيد من الترميز الجغرافي في عملك؟ هل لديك أي أسئلة أو تعليقات على Positionstack؟ اترك لنا ملاحظة في التعليقات أدناه.