Geocoding API الإصدار 4 هي خدمة توفّر الترميز الجغرافي والترميز الجغرافي العكسي للعناوين ومعرّفات الأماكن ومعلومات الوجهة.
الترميز الجغرافي هو عملية تحويل العناوين (مثل عنوان شارع) إلى إحداثيات جغرافية (مثل خطوط الطول والعرض)، ويمكنك استخدامها لوضع علامات على خريطة أو تحديد موضع الخريطة.
عكس الترميز الجغرافي هو عملية تحويل الإحداثيات الجغرافية إلى عنوان يمكن قراءته.
يمكنك أيضًا استخدام Geocoding API للعثور على عنوان معرّف مكان معيّن.
نموذج الطلب والاستجابة
يمكنك الوصول إلى Geocoding API من خلال واجهة HTTP. في ما يلي أمثلة على طلبات الترميز الجغرافي والترميز الجغرافي العكسي.
طلب الترميز الجغرافي والاستجابة له (بحث عن خط العرض/خط الطول)
يطلب المثال التالي خطوط الطول والعرض الخاصة بـ "1600 Amphitheatre Parkway, Mountain View, CA"، ويحدّد أنّه يجب أن يكون الناتج بتنسيق JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
يمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي).
يتضمّن الردّ خطَّي الطول والعرض الخاصَّين بالعنوان.
يمكنك الاطّلاع على دليل المطوّرين للحصول على مزيد من المعلومات حول إنشاء عناوين URL لطلبات الترميز الجغرافي والمَعلمات المتاحة و فهم الرد.
في ما يلي نموذج لاستجابة الترميز الجغرافي بتنسيق JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
طلب البحث عن عكس الترميز الجغرافي والاستجابة له (البحث عن العنوان)
يطلب المثال التالي العنوان المتوافق مع خطوط الطول والعرض المحدّدة في بروكلين، نيويورك، الولايات المتحدة الأمريكية. تحدّد هذه السمة أنّ الناتج يجب أن يكون بتنسيق JSON.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYيمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي). يتضمّن الرد عنوانًا يمكن قراءته للموقع الجغرافي الذي يحدّده خط الطول وخط العرض.
يمكنك الاطّلاع على دليل المطوّرين للحصول على مزيد من المعلومات حول إنشاء عناوين URL لطلبات الترميز الجغرافي العكسي والمَعلمات المتاحة و فهم الرد.
في ما يلي نموذج لاستجابة الترميز الجغرافي العكسي بتنسيق JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
المصادقة والحصص والأسعار والسياسات
المصادقة
لاستخدام Geocoding API، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على بدء استخدام "منصة خرائط Google".
الحصص والأسعار
راجِع صفحة الاستخدام والفوترة للحصول على تفاصيل حول الحصص والأسعار المحدّدة لواجهة Geocoding API.
السياسات
يجب أن يكون استخدام Geocoding API متوافقًا مع سياسات واجهة برمجة التطبيقات.