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

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

Positionstack 101

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

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

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

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

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

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

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

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

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

لوحة القيادة الخاصة بك Positionstack

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

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

وثائق API

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

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

ابدء

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

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

نقاط نهاية API

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

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

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

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

https://api.positionstack.com/v1/forward
    ؟ access_key = YOUR_ACCESS_KEY
    & الاستعلام = 1600 Pennsylvania Ave NW، Washington DC

أو

https://api.positionstack.com/v1/reverse
    ؟ access_key = YOUR_ACCESS_KEY
    & الاستعلام = 40.7638435، -73.9729691

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

{
   "البيانات": {
      "النتائج": [
         {
            "خط العرض": 38.897675 ،
            "خط الطول": -77.036547 ،
            "label": "1600 Pennsylvania Avenue NW، Washington، DC، USA"،
            "الاسم": "1600 Pennsylvania Avenue NW"،
            "type": "address"،
            "الرقم": "1600"،
            "شارع": "شارع بنسلفانيا شمال غرب" ،
            "الرمز_البريدي": "20500"،
            "الثقة": 1 ،
            "المنطقة": "مقاطعة كولومبيا" ،
            "region_code": "DC"،
            "المنطقة_الإدارية": خالية ،
            "الحي": "أراضي البيت الأبيض" ،
            "البلد: الولايات المتحدة الأمريكية"،
            "country_code": "US"،
            "map_url": "https://map.positionstack.com/38.897675،-77.036547"
         }
      ]
   }
}

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

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

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

طلبات الدفعة

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

{
   "حزمة":[
      {
         "استعلام": "الشارع الرئيسي"،
         "البلد": "الولايات المتحدة"،
         "المنطقة": "مينيسوتا"
      } ،
      {
         "استعلام": "الشارع الرئيسي"،
         "البلد": "الولايات المتحدة"،
         "المنطقة": "إلينوي"
      } ،
      {
         "استعلام": "الشارع الرئيسي"،
         "البلد": "الولايات المتحدة"،
         "المنطقة": "ميسوري"
      }
   ]
}

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

In addition to the basic location parameters, you can further tailor your API requests to return more advanced data. These include:

• Embeddable Maps – Returns a map_url object linked to your geocoding result, which you can use to create an attractive visual map representation on your website or app.
• Country Module – Unlike other parameters which return up to a few response objects, country_module returns an incredible array of data about your queried country. It’s not just coordinates and addresses, either; it’s the capital, flag, official name, status as a landlocked (or not) country, currencies used, languages spoken, calling codes, and more.
• Sun Module – Humorously, Positionstack’s documentation describes this as “Astrological” data. You won’t be getting your horoscope with this parameter, but you will see data about when the sun rises and sets, according to astronomical, civil, and nautical chronology.
• Timezone Module – Append timezone_module to return a location’s GMT offset in either seconds or as a natural language string.
• Bounding Box Module ­­– If a single x/y pair of coordinates isn’t right for your task, try a bounding box, which encloses an area with minimum and maximum values for longitude and latitude.

Additional Options

The Positionstack API has a ton of data to throw at you, but luckily it provides you with additional tools to manage this trove of information.

• Specify Response Fields – We’ve covered in depth how much data Positionstack can return, but keep in mind that all that data comes at a cost. If you want to limit your monthly requests, you can do that with the fields Appending fields = results.flag, for example, will cause the API to output only your queried country’s flag. You can invoke fields as many times as you need to get the specific dataset you require.
• Specify Output Format – Free subscribers are limited to the JSON format for their returned geocoding results. Paying customers, however, can append output on their requests to specify JSON, XML, or GeoJSON as necessary. 

Code Examples 

When Positionstack says they’re here to help you, they mean it. We’ve already seen how thorough their documentation is, but they top it off with handy code examples in all the languages their API supports. We’re not going to copy/paste that code here, but for quick reference, those languages are:

• Python
• Nodejs
• jQuery
• Go
• Ruby

Proof and performance

At this point, it should be clear that Positionstack is capable of doing quite a lot. But, how well does it do these things?

First, let’s consider some context. Positionstack is one of 20+ API microservices in Apilayer’s cloud-based ecosystem. Together, these APIs serve over a million B2B clients from startups all the way up to enterprise. Some of their most notable customers include Amazon, Apple, Slack, LinkedIn, and many more household names. Clearly, they’ve got some robust infrastructure to handle this scale of demand.

On its own merits, Positionstack lives up to its pedigree, with an incredible 100% uptime throughout 2020 at the time of writing. This is even more impressive when you consider the API routinely processes over a billion geocode lookups per day per whale client, not to mention the dizzying array of simultaneous requests coming from their stable of SMB customers. What’s more, these requests typically garner responses between 10 and 100 ms.

In our book, that’s something of a technological marvel, especially considering how aggressively priced this SaaS offering is.

And it’s not just raw power that makes Positionstack so appealing. Their dataset is truly sophisticated, sourced from reliable names like Nominatim, GeoNames, Pelias, and OpenStreetMap. Positionstack cross-checks, filters and recombines this wealth of data multiple times a day, pushing regular updates via smart algorithms that ensure you always have highly accurate location data, anywhere in the world, and in real time.

We hate to spoil our final verdict, but if you’re looking for a robust, scalable geocoding solution, Positionstack’s resume demands a closer look.

Pricing 

Apilayer set out to provide an affordable alternative to highly expensive enterprise-level geocoding software, and towards that end they have succeeded.

Positionstack comes in five pricing tiers, and supports monthly billing, or yearly subscriptions at a 20% discount. Those tiers are:

• Free – Rated for personal use, you’re still getting a good bit of mileage with 25,000 monthly requests for forward and reverse geocoding, outputted in the JSON format. You don’t get a lot of advanced features or customer support, but we’ve already shown you what a valuable resource their Documentation page is. This tier is free of charge, and free of obligation–you don’t even have to provide credit card details to get started.
• Basic – The entry-level commercial package. Basic subscribers quadruple their monthly quota to 100,000 geocoding requests, plus get access to advanced features like HTTPS encryption, multiple output options (JSON, XML, GeoJSON), embeddable maps, multiple languages, and more. Get a commercial Positionstack license for just $9.99 per month.
• Professional – Positionstack’s most popular offering, the Professional tier offers a tenfold increase in geocoding requests–up to 1,000,000 per month. All the goodies from the Basic tier are present and then some, notably including batch requests for heavy-duty applications. This tier clocks in at $49.99 per month.
• Business – Moving into enterprise-scale performance, the Business tier balloons the monthly quota to a whopping 3,000,000 requests. Once again, every advanced feature is fully available, backed by Positionstack’s passionate customer support team to help you get the most out of them. $99.99 per month.
• Enterprise – This is the tier in which standard offers go out the window, and the customer is king. You have precise needs that demand custom solutions, and Positionstack is at the ready to achieve your goals. You dictate your monthly volume requests, even (especially) if they’re variable. Need more horsepower from the API? Reach out to support for custom-built solutions. Contact Positionstack for a quote.

Verdict

Positionstack does precisely what it set out to do: bring enterprise-level geocoding down from price points otherwise out of budget to most SMBs, without sacrificing performance. Their API is well-documented and easy to use, but features robust integration across all major programming languages for maximum utility. The number of requests Positionstack routinely handles is staggering, while their dataset is smartly maintained for truly global reach in real-time geocoding. If you’re in the market for this type of product, don’t sleep on Positionstack.

What sort of integration do you have planned? How will you make use of geocoding in your business? Do you have any questions or comments on Positionstack? Leave us a note in the comments below.