أدوات المطورين

البناء باستخدام Mapcode

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

REST API: مقدمة REST API: جرّبها!

الترتيب الموصى به

  1. REST API للتكامل الأول الأسرع.
  2. TypeScript عندما تريد الترميز المحلي في تطبيقات الويب أو Node.js.
  3. Python للنصوص والبرمجيات وتحليل البيانات وسير عمل الخلفية.
  4. Java للتطبيقات الموجودة على JVM.

بداية سريعة مع REST API

استخدم REST API العام لإثبات تدفق الترميز وفك الترميز قبل اختيار تكامل أعمق. هذه الأمثلة تستخدم جبل كيليمانجارو كمعلم محايد في أفريقيا.

1. من الإحداثيات إلى mapcode

اطلب mapcodes لإحداثيات بالقرب من جبل كيليمانجارو وقم بتقييد النتيجة المحلية لتنزانيا.

الطلب 
GET https://api.mapcode.com/mapcode/json/codes/-3.0674,37.3556?territory=TZA
الاستجابة الرئيسية 
{
  "local": {
    "mapcode": "86.W6V5",
    "territory": "TZA"
  }
}

2. من mapcode إلى الإحداثيات

فك ترميز mapcode المحلي إلى نقطة المركز للمنطقة الممثلة.

الطلب 
GET https://api.mapcode.com/mapcode/json/coords/TZA%2086.W6V5
الاستجابة الرئيسية 
{
  "latDeg": -3.0673755,
  "lonDeg": 37.3555635
}

الاختلافات الطفيفة في الإحداثيات بعد فك الترميز طبيعية لأن mapcode يمثل منطقة صغيرة بدلاً من نقطة الإدخال الأصلية الدقيقة.

افتح وثائق REST API الكاملة

المكتبات

استخدم مكتبة عندما تريد ترميز وفك ترميز Mapcode داخل تطبيقك الخاص دون الاعتماد على مكالمات الشبكة.

TypeScript

المكتبة الموصى بها لمشاريع الويب وNode.js وTypeScript.

حزمة npm المصدر على GitHub

تثبيت 
npm install mapcode-ts
ترميز وفك ترميز 
import { encodeToShortest, decode, Territory } from "mapcode-ts";

const code = encodeToShortest(-3.0674, 37.3556, Territory.TZA);
console.log(code.getCodeWithTerritory()); // TZA 86.W6V5

const point = decode("TZA 86.W6V5");
console.log(point.getLatDeg(), point.getLonDeg());

Python

استخدم Python للنصوص وسير عمل البيانات وخدمات الخلفية.

حزمة PyPI المصدر على GitHub

تثبيت 
pip install mapcode
ترميز وفك ترميز 
import mapcode

print(mapcode.encode(-3.0674, 37.3556, "TZA")[0])
print(mapcode.decode("TZA 86.W6V5"))

Java

استخدم Java عند دمج Mapcode في تطبيق JVM موجود.

بيانات MetaData الخاصة بـ Maven المصدر على GitHub توثيق Java

اعتماد Maven 
<dependency>
  <groupId>com.mapcode</groupId>
  <artifactId>mapcode</artifactId>
  <version>2.4.19</version>
</dependency>
ترميز وفك ترميز 
import com.mapcode.Mapcode;
import com.mapcode.MapcodeCodec;
import com.mapcode.Point;
import com.mapcode.Territory;

Mapcode code = MapcodeCodec.encodeToShortest(-3.0674, 37.3556, Territory.TZA);
System.out.println(code.getCodeWithTerritory());

Point point = MapcodeCodec.decode("TZA 86.W6V5");
System.out.println(point.getLatDeg() + ", " + point.getLonDeg());

أدوات أخرى

تظل هذه الأدوات متاحة، لكن معظم التكاملات الفنية الجديدة يجب أن تبدأ بـ REST أو TypeScript أو Python.

أداة سطر الأوامر

مصدر C/C++ يتضمن أداة سطر أوامر متعددة المنصات لتشفير وفك تشفير رموز Mapcode.

MyMapcodes.com

قد ترغب في استخدام MyMapcodes.com لإيجاد رموز Mapcode بسهولة، أيضًا على هاتفك. MyMapcodes هو موقع مجاني غير تابع.

الأدوات القديمة

لا تزال الأدوات القديمة لنظام Windows متاحة من أجل الراحة، لكنها ليست المسار الموصى به للدمج الجديد.

تشفير الموقع -33.93, 18.8: 
mapcode -e -33.93, 18.8
فك تشفيره مرة أخرى: 
mapcode -d ZAF WK.QV5
تحويل رمز Mapcode إلى إحداثيات: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/coords/Q4.HGY?context=NLD")
تحويل الإحداثيات مرة أخرى إلى رموز Mapcode: 
=WEBSERVICE("https://api.mapcode.com/mapcode/xml/codes/52.460897,5.1074585")