البدء

واجهة برمجة التطبيقات للترميز الجغرافي هي خدمة تقدّم الترميز الجغرافي والترميز الجغرافي للعناوين.

الترميز الجغرافي هي عملية تحويل العناوين (مثل عنوان الشارع) إلى إحداثيات جغرافية (مثل خط الطول وخط العرض)، والتي يمكنك استخدامها لوضع العلامات على الخريطة، أو لتحديد موضع الخريطة.

الترميز الجغرافي العكسي هو عملية تحويل الإحداثيات الجغرافية إلى عنوان يمكن للمستخدمين قراءته.

يمكنك أيضًا استخدام واجهة برمجة تطبيقات الترميز الجغرافي للعثور على العنوان الخاص برقم تعريف مكان معيّن.

نموذج للطلب والاستجابة

يمكنك الوصول إلى واجهة برمجة تطبيقات الترميز الجغرافي من خلال واجهة HTTP. في ما يلي أمثلة على طلبات الترميز الجغرافي والترميز الجغرافي العكسي.

طلب الترميز الجغرافي والاستجابة (البحث في خطوط الطول/العرض)

يطلب المثال التالي خطوط العرض والطول لـ "1600 Amphitheatre Parkway, Mountain View, CA" ويشير إلى أنّ النتائج يجب أن تكون بتنسيق JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

ويمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي). يتضمن الرد خط العرض وخط الطول للعنوان.

يُرجى الاطّلاع على دليل مطوّري البرامج لمعرفة مزيد من المعلومات حول إنشاء عناوين URL لطلبات الترميز الجغرافي والمعلّمات المتاحة و فهم الاستجابة.

في ما يلي نموذج لاستجابة الترميز الجغرافي، بالترميز JSON:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Parkway",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4267861,
               "lng" : -122.0806032
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4281350802915,
                  "lng" : -122.0792542197085
               },
               "southwest" : {
                  "lat" : 37.4254371197085,
                  "lng" : -122.0819521802915
               }
            }
         },
         "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
         "plus_code" : {
            "compound_code" : "CWC8+R3 Mountain View, California, United States",
            "global_code" : "849VCWC8+R3"
         },
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

طلب الاستجابة العكسية حسب الموقع الجغرافي والاستجابة (البحث عن العنوان)

يطلب المثال التالي العنوان المقابل لخط عرض/خط عرض معيّن في بروكلين، نيويورك، الولايات المتحدة الأمريكية. يجب تحديد أن تكون النتائج بتنسيق JSON.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

ويمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال "YOUR_API_KEY" بمفتاح واجهة برمجة التطبيقات الفعلي). تتضمّن الاستجابة عنوانًا يمكن للمستخدمين قراءته لخط العرض وخط الطول.

يُرجى الاطّلاع على دليل مطوّري البرامج لمعرفة مزيد من المعلومات حول إنشاء عناوين URL لطلبات الترميز الجغرافي العكسي والمعلّمات المتاحة و فهم الاستجابة.

في ما يلي نموذج لاستجابة الترميز العكسي بتنسيق JSON:

{
   "plus_code" : {
      "compound_code" : "P27Q+MC New York, NY, USA",
      "global_code" : "87G8P27Q+MC"
   },
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "279",
               "short_name" : "279",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "political", "sublocality", "sublocality_level_1" ]
            },
            {
               "long_name" : "Kings County",
               "short_name" : "Kings County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "New York",
               "short_name" : "NY",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "11211",
               "short_name" : "11211",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142484,
               "lng" : -73.9614103
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71559738029149,
                  "lng" : -73.9600613197085
               },
               "southwest" : {
                  "lat" : 40.71289941970849,
                  "lng" : -73.96275928029151
               }
            }
         },
         "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
         "plus_code" : {
            "compound_code" : "P27Q+MC Brooklyn, New York, United States",
            "global_code" : "87G8P27Q+MC"
         },
         "types" : [
            "bakery",
            "cafe",
            "establishment",
            "food",
            "point_of_interest",
            "store"
         ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

بدء الترميز باستخدام مكتبات العملاء

وتسهّل مكتبات العملاء عملية التطوير باستخدام واجهات برمجة تطبيقات خدمات الويب في "خرائط Google"، حيث توفّر عمليات تنفيذ بسيطة وأصلية للمهام الشائعة، مثل المصادقة وطلب التقييد وإعادة المحاولة تلقائيًا. تتوفّر واجهة برمجة التطبيقات للترميز الجغرافي في Java Client و Python Client وGo Client وNode.js Client لخدمات "خرائط Google".

المصادقة والحصص والأسعار والسياسات

المصادقة

لاستخدام واجهة برمجة تطبيقات الترميز الجغرافي، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة الصحيحة. ولمزيد من المعلومات، يمكنك الاطّلاع على بدء استخدام "منصة خرائط Google".

الحصص والأسعار

راجِع صفحة الاستخدام والفوترة للحصول على تفاصيل حول الحصص والأسعار التي تم ضبطها لواجهة برمجة التطبيقات Geocoding API.

السياسات

يجب أن يكون استخدام واجهة برمجة التطبيقات للترميز الجغرافي متوافقًا مع سياسات واجهة برمجة التطبيقات.

مزيد من المعلومات

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

يصف دليل مطوّري برامج واجهة برمجة التطبيقات لترميز المواقع الجغرافية خدمة الويب لواجهة برمجة تطبيقات Geocoding API. وهي موجّهة لمطوّري برامج المواقع الإلكترونية والأجهزة الجوّالة الذين يريدون استخدام بيانات الترميز الجغرافي ضمن الخرائط التي تقدّمها إحدى واجهات برمجة تطبيقات "منصة خرائط Google".