نظرة عامة على واجهة برمجة التطبيقات للترميز الجغرافي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
Geocoding API هي خدمة تقبل مكانًا على أنّه
عنوان أو إحداثيات خطوط العرض والطول أو معرّف مكان. وتحوِّل هذه الدالة
العنوان إلى إحداثيات خط العرض وخط الطول ومعرّف مكان، أو تحوِّل
إحداثيات خط العرض وخط الطول أو معرّف مكان إلى عنوان.
أهمية استخدام واجهة برمجة التطبيقات Geocoding API
استخدِم واجهة برمجة التطبيقات Geocoding API للموقع الإلكتروني أو التطبيق المتوافق مع الأجهزة الجوّالة عندما تريد استخدام data
الترميز الجغرافي ضمن الخرائط التي تقدّمها إحدى واجهات برمجة التطبيقات في Google Maps Platform.
باستخدام Geocoding API، يمكنك استخدام العناوين لوضع علامات على خريطة أو
تحويل علامة على خريطة إلى عنوان. تم تصميم هذه الخدمة لترميز المواقع الجغرافية
للعناوين الثابتة المحدّدة مسبقًا من أجل وضع محتوى التطبيق
على الخريطة.
الإجراءات التي يمكنك تنفيذها باستخدام Geocoding API
يمكنك استخدام واجهة برمجة التطبيقات Geocoding API للحصول على بيانات ترميز جغرافي لعنوان واحد أو أكثر أو
مكان، بما في ذلك ما يلي:
الإحداثيات الجغرافية للعناوين
عناوين مجموعات إحداثيات خطوط العرض وخط الطول
عناوين معرّفات الأماكن
يمكنك التحكّم في أماكن ظهور النتائج وحصرها في منطقة أو
مقاطعة أو رمز بريدي معيّن.
طريقة عمل واجهة برمجة التطبيقات Geocoding API
تُجري واجهة برمجة التطبيقات Geocoding API كلاً من الترميز الجغرافي وعكس الترميز الجغرافي:
ترميز الموقع الجغرافي: لتحويل العناوين، مثل
"1600 Amphitheatre Parkway, Mountain View, CA" إلى إحداثيات خط العرض وخط الطول أو أرقام تعريف
الأماكن يمكنك استخدام هذه الإحداثيات لوضع علامات على خريطة أو توسيط الخريطة أو تغيير موضعها
ضمن إطار العرض.
الترميز الجغرافي العكسي: يحوّل
إحداثيات خطوط الطول والعرض أو رقم تعريف مكان إلى عنوان يمكن لشخص عادي قراءته. يمكنك استخدام
العناوين لمجموعة متنوعة من السيناريوهات، بما في ذلك عمليات التسليم أو الاستلام.
يستخدم العرض الترويجي التالي خدمة ترميز المواقع الجغرافية من خلال واجهة برمجة التطبيقات Maps JavaScript API
لعرض طريقة عمل واجهة برمجة التطبيقات Geocoding API. افتح الخريطة في علامة تبويب منفصلة
للاطّلاع على المزيد من الخيارات والتفاصيل.
الموارد
يلخّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات
Geocoding API بالإضافة إلى البيانات التي تعرضها كل نقطة نهاية.
بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك بدء اختبار واجهة برمجة التطبيقات Geocoding API مباشرةً من
curl أو متصفّح. ستحتاج إلى تقديم مَعلمات البحث الصحيحة
لعمليات البحث عن العناوين أو المكوّنات. اطّلِع على
مَعلمات ترميز المواقع الجغرافية
لمعرفة التفاصيل.
3
تجربة طلب عكس الترميز الجغرافي
قدِّم إحداثيات خط الطول/العرض مع مفتاح واجهة برمجة التطبيقات للحصول على
عناصر العنوان لأقرب عنوان يمكن لشخص عادي قراءته لهذا الموقع الجغرافي.
اطّلِع على طلبات الترميز الجغرافي العكسي
للاطّلاع على التفاصيل.
4
التعرّف على أساسيات الاستجابة
تعرض جميع نقاط النهاية في واجهة برمجة التطبيقات Geocoding API البيانات نفسها بتنسيق JSON أو XML.
اطّلِع على
الردود المتعلّقة بترميز المواقع الجغرافية
للحصول على شرح للبيانات ورموز الحالة ورسائل الخطأ.
5
دمج بيانات ترميز الموقع الجغرافي في تطبيقك
يمكنك استخدام بيانات الترميز الجغرافي للحصول على عناوين من علامات الخريطة
أو لتقديم علامات على خريطة استنادًا إلى عنوان معروف.
مكتبات العملاء المتاحة
يمكنك طلب بيانات من واجهة برمجة التطبيقات هذه بلغة
اختيارك من خلال إحدى مكتبات العملاء التالية:
مكتبة Java Client وPython Client وGo Client وNode.js Client لخدمات Google
Maps هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية بموجب ترخيص Apache 2.0.
يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونماذج الرموز البرمجية.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Geocoding API converts addresses into geographic coordinates (latitude and longitude) and vice versa.\u003c/p\u003e\n"],["\u003cp\u003eThis API is ideal for placing markers on maps based on addresses and retrieving addresses from map locations for static content, not dynamic user input.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Geocoding API to find geographic coordinates for addresses, addresses for coordinates, and addresses for Place IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports both geocoding (address to coordinates) and reverse geocoding (coordinates to address).\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq). \n\nThe Geocoding API is a service that accepts a place as an\naddress, latitude and longitude coordinates, or Place ID. It converts the\naddress into latitude and longitude coordinates and a Place ID, or converts\nlatitude and longitude coordinates or a Place ID into an address.\n| **Note** : If you only want plus codes and don't want to use an API key, you can use the [Plus codes API](https://github.com/google/open-location-code/tree/main/Documentation).\n\nWhy use the Geocoding API\n\nUse the Geocoding API for website or mobile application when you want to use\ngeocoding data within maps provided by one of the Google Maps Platform APIs.\nWith the Geocoding API, you use addresses to place markers on a map, or\nconvert a marker on a map to an address. This service is designed for geocoding\n**predefined, static addresses** for placement of application\ncontent on a map.\n| This service is **not** designed to respond directly to user\n| input. To do dynamic geocoding, for example, in a user interface, see the\n| [Maps JavaScript API\n| client geocoder](/maps/documentation/javascript/geocoding) and/or the\n| [Google Play services Location APIs](https://developer.android.com/google/play-services/location.html).\n\nWhat you can do with the Geocoding API\n\nYou can use the Geocoding API to obtain geocoding data for one or more addresses or\nplaces, including the following:\n\n- Geographic coordinates for addresses.\n- Addresses for sets of latitude and longitude coordinates.\n- Addresses for place IDs.\n\nYou can control where the results appear and constrain the results to a particular region,\ncounty, or postal code.\n\nHow the Geocoding API works\n\nThe Geocoding API does both geocoding and reverse geocoding:\n\n- [**Geocoding**](/maps/documentation/geocoding/requests-geocoding): Converts addresses such as \"1600 Amphitheatre Parkway, Mountain View, CA\" into latitude and longitude coordinates or Place IDs. You can use these coordinates to place markers on a map, or to center or reposition the map within the view frame.\n- [**Reverse geocoding**](/maps/documentation/geocoding/requests-reverse-geocoding): Converts latitude/longitude coordinates or a Place ID into a human-readable address. You can use addresses for a variety of scenarios, including deliveries or pickups.\n\nThe following demo uses the Geocoding Service through the Maps JavaScript API\nto demonstrate how the Geocoding API works. Open the map in a separate tab\nto see more options and details.\n\nResources\n\nThe following table summarizes the resources available through the\nGeocoding API along with the data each endpoint returns.\n\n| Data resources | Data returned | Return format |\n|-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Geocoding](/maps/documentation/geocoding/requests-geocoding) | Returns address, address components, and address types. See [Results](/maps/documentation/geocoding/requests-geocoding#results) in the *Geocoding request and response* guide. | - JSON - XML |\n| [Reverse geocoding](/maps/documentation/geocoding/requests-reverse-geocoding) | Returns address, address components, and address types. See [Reverse geocoding responses](/maps/documentation/geocoding/requests-reverse-geocoding#reverse-response) in the Reverse geocoding request and response guide. | - JSON - XML |\n| [Place geocoding](/maps/documentation/geocoding/requests-places-geocoding) | Returns address, address components, and address types. See [Reverse geocoding responses](/maps/documentation/geocoding/requests-places-geocoding) in the Place geocoding request and response guide. | - JSON - XML |\n| - JSON - XML |\n\nHow to use the Geocoding API\n\n|---|---------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/geocoding/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try a geocoding request** | Once you have an API key, you can start testing out the Geocoding API directly from curl or a browser. You'll need to supply the correct lookup parameters for address or component lookups. See [Geocoding parameters](/maps/documentation/geocoding/requests-geocoding#geocoding-lookup) for details. |\n| 3 | **Try a reverse geocoding request** | Supply latitude/longitude coordinates along with your API key to obtain address components for the closest human-readable address for that location. See [Reverse geocoding requests](/maps/documentation/geocoding/requests-reverse-geocoding#reverse-requests) for details. |\n| 4 | **Understand response basics** | All endpoints in the Geocoding API return the same data in either JSON or XML. See [Geocoding responses](/maps/documentation/geocoding/requests-geocoding#GeocodingResponses) for an explanation of the data, status codes, and error messages. |\n| 5 | **Incorporate geocoding data into your own app!** | You can use geocoding data to obtain addresses from map markers or to supply markers on a map based on a known address. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Geocoding API** : Go to [Set up your\n Google Cloud project](/maps/documentation/geocoding/cloud-setup).\n- **Get started with sample requests and responses** : Go to [Geocoding requests and responses](/maps/documentation/geocoding/requests-geocoding)\n- **Follow best practices** : Go to [Geocoding Addresses Best\n Practices](/maps/documentation/geocoding/best-practices)."]]
