واجهات API
ثماني نقاط نهاية تحت https://api.mygeocode.com/v1/. تقبل كل منها معاملات الاستعلام في طلب GET وتعيد JSON. وتتشارك في حصة واحدة، ومجموعة واحدة من رموز الأخطاء، وسعر واحد.
واجهة API للترميز الجغرافي الأمامي
نقطة النهاية GET /v1/forwardأرسل عنوانًا أو اسم مكان أو وصفًا تقريبيًا، واحصل على الإحداثيات وعنوان منقّح وكل جزء من أجزائه.
التفاصيل والأمثلةواجهة API للترميز الجغرافي العكسي
نقطة النهاية GET /v1/reverseأرسل خط العرض وخط الطول واحصل على أقرب عنوان، مع المدينة والمنطقة والرمز البريدي والدولة مفصّلة.
التفاصيل والأمثلةواجهة API للإكمال التلقائي للعناوين
نقطة النهاية GET /v1/autocompleteاقترح العناوين أثناء الكتابة. كل اقتراح يأتي مع إحداثياته، لذا نادرًا ما تحتاج إلى استدعاء ثانٍ.
التفاصيل والأمثلةواجهة API للاستعلام عن IPv4
نقطة النهاية GET /v1/ipv4الدولة والمنطقة والمدينة والإحداثيات والمنطقة الزمنية ومالك الشبكة لأي عنوان IPv4، أو للمستدعي إذا لم تحدد عنوانًا.
التفاصيل والأمثلةواجهة API للاستعلام عن IPv6
نقطة النهاية GET /v1/ipv6التفاصيل نفسها لعناوين IPv6، إضافة إلى البادئة المعلنة التي ينتمي إليها العنوان.
التفاصيل والأمثلةواجهة API للاستعلام عن المنطقة الزمنية
نقطة النهاية GET /v1/timezoneاسم المنطقة الزمنية وفق IANA، وفارق التوقيت عن UTC، وحالة التوقيت الصيفي، والوقت المحلي لأي إحداثيات، الآن أو عند طابع زمني تختاره.
التفاصيل والأمثلةواجهة API للاستعلام عن الارتفاع
نقطة النهاية GET /v1/elevationالارتفاع فوق مستوى سطح البحر بالأمتار لنقطة واحدة، أو لما يصل إلى 100 نقطة في استدعاء واحد.
التفاصيل والأمثلةواجهة API للاستعلام عن الرمز البريدي
نقطة النهاية GET /v1/postcodeحوّل الرمز البريدي إلى اسم مكان ومنطقة وإحداثيات. يعمل مع رموز ZIP والرموز البريدية وما يعادلها في معظم الدول.
التفاصيل والأمثلةما تشترك فيه
الغلاف نفسه
لكل استجابة حقل status في المستوى الأعلى قيمته ok أو error. تحمل الأخطاء رمز code قابلًا للقراءة آليًا وجملة يمكنك تسجيلها. والإحداثيات دائمًا بالدرجات العشرية في lat وlon.
القواعد نفسها في كل مكان
يحصل أي عنوان على 2,500 طلب مجاني يوميًا دون مفتاح. ولكل مفتاح 2,500 طلب مجاني يوميًا خاصة به (يتقاسمها مع الطلبات دون مفتاح من الشبكة نفسها)، ثم الرصيد مسبق الدفع أو باقة Unlimited. مفتاح الدفع حسب الاستخدام يخدم عنواني IP خلال كل 24 ساعة متتالية، ومفتاح Unlimited ثلاثة عناوين. راجع المصادقة.
السعر نفسه
الترميز الجغرافي العكسي يكلف ما يكلفه الاستعلام عن IP: لا شيء لأول 2,500 طلب يوميًا على كل مفتاح، ثم 0.0001 € لكل طلب من الرصيد مسبق الدفع، أو 50 € شهريًا لمفتاح Unlimited. راجع الأسعار.
ما الذي يُحتسب طلبًا واحدًا
كل شيء تقريبًا يعني استدعاءً واحدًا وطلبًا واحدًا. والاستثناء هو الاستدعاءات المجمّعة، حيث يُحتسب كل عنصر في الدفعة على حدة.
| نقطة النهاية | يُحتسب بوصفه |
|---|---|
| الترميز الجغرافي الأمامي، والترميز الجغرافي العكسي، والاستعلام عن الرمز البريدي | 1 طلب لكل استدعاء، بغض النظر عن عدد النتائج العائدة |
| الإكمال التلقائي للعناوين | 1 طلب لكل استدعاء. قلّل تكرار الاستدعاءات مع ضغطات المفاتيح (debounce) في تطبيق العميل؛ وستقوم حزم SDK بذلك نيابة عنك |
| الاستعلام عن IPv4 وIPv6 | 1 طلب لكل استدعاء، أو 1 لكل عنوان في الدفعة |
| الاستعلام عن المنطقة الزمنية | 1 طلب لكل استدعاء |
| الاستعلام عن الارتفاع | 1 طلب لكل نقطة. الاستدعاء الذي يحتوي على 20 نقطة يُحتسب 20 |
| المضيفات البديلة المتوافقة (Google وBing وHERE وغيرها) | القواعد نفسها المطبقة على نقطة النهاية التي تستند إليها |
| بدائل JavaScript المتوافقة: تحميلات الخرائط والمربعات | 0. لا تُحتسب إلا استدعاءات الترميز الجغرافي والإكمال التلقائي والارتفاع |
غير متوفر بعد
حساب المسارات ومصفوفات المسافات وخطوط التساوي الزمني ليست جزءًا من الخدمة وليست مخططة لهذا العام. والبحث عن نقاط الاهتمام حسب الفئة قيد الدراسة. إذا كنت تحتاج إلى أحد هذه لكي تنتقل، أخبرنا؛ فهذا يساعدنا على تحديد ما نبنيه بعد ذلك.