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

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

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

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

يمكنك أيضًا استخدام Geocoding API للعثور على عنوان المحدد لرقم تعريف المكان.

نموذج طلب وردّ

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

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

يطلب المثال التالي خط العرض وخط الطول لـ " 1600 Amphitheatre باركواي، ماونتن فيو، كاليفورنيا"، ويحدد أن المخرجات يجب أن يكون بتنسيق 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 Python Client وGo Client وNode.js Client لخدمات "خرائط Google"

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

المصادقة

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

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

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

السياسات

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

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

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

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