‏‫الخطوات الأولى

‫Geocoding API هي خدمة توفّر الترميز الجغرافي وعكس الترميز الجغرافي للعناوين.

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

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

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

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

يمكنك الوصول إلى واجهة برمجة التطبيقات Geocoding API من خلال واجهة 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" من خلال توفير عمليات تنفيذ بسيطة ومضمّنة للمهام الشائعة، مثل المصادقة وتقييد معدل إرسال الطلبات وإعادة المحاولة التلقائية. تتوفّر واجهة برمجة التطبيقات Geocoding API في Java Client (عميل Java) Python Client (عميل Python) وGo Client (عميل Go) وNode.js Client (عميل Node.js) لخدمات "خرائط Google".

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

المصادقة

لاستخدام واجهة برمجة التطبيقات Geocoding API، عليك أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على بدء استخدام Google Maps Platform.

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

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

السياسات

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

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

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

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