جرّب واجهة API

اختر نقطة نهاية، وغيّر القيم، واضغط «إرسال». ينتقل الطلب من متصفحك إلى api.mygeocode.com وتُفتح إجابة JSON في علامة تبويب جديدة. ويُحتسب ضمن 2,500 طلب مجاني يوميًا يحصل عليها عنوانك دون مفتاح، أو الصق مفتاحًا ليُحتسب على المفتاح بدلًا من ذلك. تريد مفتاحًا؟ أنشئ حسابًا بعنوان بريد إلكتروني وسيكون لديك خلال دقيقة.

طلب GET /v1/forward

من 1 إلى 10، والقيمة الافتراضية 5

رموز ISO 3166-1 alpha-2 مفصولة بفواصل

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "query": "221B Baker Street, London",
  "results": [
    {
      "formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
      "lat": 51.523767,
      "lon": -0.158555,
      "type": "address",
      "precision": "house",
      "confidence": 0.97,
      "place_id": "gb.addr.7f3c2a19",
      "components": {
        "house_number": "221B",
        "road": "Baker Street",
        "neighbourhood": "Marylebone",
        "city": "London",
        "state": "England",
        "postcode": "NW1 6XE",
        "country": "United Kingdom",
        "country_code": "gb"
      },
      "bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
    }
  ]
}

جرّب حذف رقم المنزل ولاحظ كيف تتغير قيمة precision من house إلى street. المرجع

طلب GET /v1/reverse

address أو street أو postcode أو city أو region أو country

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "lat": 48.8584,
  "lon": 2.2945,
  "result": {
    "formatted": "5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.85837,
    "lon": 2.29448,
    "distance_m": 12,
    "type": "address",
    "precision": "house",
    "components": {
      "house_number": "5",
      "road": "Avenue Anatole France",
      "suburb": "7th Arrondissement",
      "city": "Paris",
      "state": "Ile-de-France",
      "postcode": "75007",
      "country": "France",
      "country_code": "fr"
    }
  }
}

جرّب 0 و0: ستحصل على "result": null مع status: ok، لأن نقطة في المحيط سؤال صالح. المرجع

نقطة النهاية GET /v1/autocomplete

2 أحرف على الأقل

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "query": "10 Downing",
  "suggestions": [
    { "text": "10 Downing Street, London SW1A 2AA, United Kingdom", "lat": 51.503396, "lon": -0.12764, "type": "address", "precision": "house", "place_id": "gb.addr.7f3c2a19" },
    { "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom", "lat": 52.203042, "lon": 0.121811, "type": "address", "precision": "house", "place_id": "gb.addr.a01d9e44" },
    { "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom", "lat": 51.536118, "lon": 0.137204, "type": "address", "precision": "house", "place_id": "gb.addr.c58b7e02" }
  ]
}

يحمل كل اقتراح إحداثياته، لذا لا يحتاج اختيار أحدها إلى استدعاء ثانٍ. المرجع

نقطة النهاية GET /v1/ipv4

امسحه للاستعلام عن عنوانك أنت

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "ip": "8.8.8.8",
  "version": 4,
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

المرجع

نقطة النهاية GET /v1/ipv6

امسحه للاستعلام عن عنوانك أنت

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "ip": "2001:4860:4860::8888",
  "version": 6,
  "prefix": "2001:4860::/32",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

المرجع

نقطة النهاية GET /v1/timezone

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "dst": false,
  "timestamp": 1756335245,
  "local_time": "2026-08-28T08:34:05+09:00",
  "country_code": "JP",
  "next_transition": null
}

المرجع

نقطة النهاية GET /v1/elevation

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "results": [
    { "lat": 27.9881, "lon": 86.925, "elevation_m": 8752.1, "resolution_m": 30 }
  ]
}

لعدة نقاط دفعة واحدة استخدم locations=lat,lon|lat,lon بدلًا من ذلك. المرجع

نقطة النهاية GET /v1/postcode

ISO 3166-1 alpha-2. يوصى به بشدة

مثال على الاستجابة للقيم المعروضة

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

المرجع

قراءة الاستجابة. تحتوي كل استجابة على حقل status. تحمل نتائج الترميز الجغرافي قيمة precision هي house أو street أو postcode أو admin لتعرف مدى الثقة بالنقطة. تتضمن ترويسات الاستجابة X-Quota-Used وX-Quota-Reset، وتعرضها أدوات المطوّر في متصفحك. تُحذف الحقول الاختيارية الفارغة من الطلب. يُرسل مفتاحك هنا في المعامل key لأن النموذج لا يستطيع ضبط ترويسة، أما في الكود فاستخدم الترويسة X-API-Key. راجع التوثيق لمعرفة كل حقل.