يمكنك استخدام Places Service وGeocoding API مع Maps SDK for Android للبحث عن مناطق والحصول على مزيد من المعلومات حول الأماكن. تُعدّ خدمة Places API وGeocoding API بديلَين قويَّين ومستقرَّين للحصول على أرقام تعريف الأماكن. إذا كنت تستخدم معرّفات الأماكن، يمكنك إعادة استخدامها مع ميزة "تحديد الأنماط المستند إلى البيانات" للحدود.
أضِف "خدمة الأماكن" و"ترميز الموقع الجغرافي" إلى تطبيقاتك التي تستخدم "حزمة تطوير البرامج لنظام التشغيل Android" في "خرائط Google" بالطرق التالية:
تعرض Places API معلومات حول الأماكن باستخدام طلبات HTTP.
يمكن لفئة الترميز الجغرافي
ترميز المواقع الجغرافية وعكس ترميزها جغرافيًا بشكل ديناميكي من إدخال المستخدم.
تتيح لك Geocoding API ترميز المواقع الجغرافية لعناوين ثابتة ومعروفة.
استخدام "خدمة الأماكن"
استخدام ميزة "البحث النصي" (جديدة) للعثور على معرّف مكان
يمكنك استخدام واجهة Text Search (New)
REST API في Places API للحصول على معرّف مكان يتضمّن بيانات المنطقة
من خلال تحديد places.id في قناع الحقل. لا يتم تحصيل أي رسوم مقابل استخدام ميزة "البحث النصي" (الجديدة) لطلب معرّفات الأماكن فقط. مزيد من المعلومات
على سبيل المثال، للحصول على معرّف المكان الخاص بمدينة ترينيداد في كاليفورنيا، يمكنك إجراء طلب البيانات التالي من واجهة برمجة التطبيقات:
يمكن أن تكون خدمة تفاصيل المكان في Places SDK for Android مفيدة جدًا لأنّها تعرض بيانات خاصة بمنطقة معيّنة. يمكنك مثلاً:
البحث عن معرّفات الأماكن الحدودية استنادًا إلى أسماء الأماكن
الحصول على إطار العرض لتكبير منطقة حدودية
احصل على نوع الميزة للحدود (على سبيل المثال locality).
احصل على العنوان المنسّق الذي يتم تحويله إلى "اسم المكان، الولاية، البلد" في منطقة الولايات المتحدة (على سبيل المثال، "أوتوموا، آيوا، الولايات المتحدة").
الحصول على بيانات مفيدة أخرى، مثل الصور
استخدام Geocoding API
تتيح لك Geocoding API تحويل
عنوان إلى إحداثيات خطوط العرض والطول ومعرّف مكان، أو تحويل
إحداثيات خطوط العرض والطول أو معرّف مكان إلى عنوان. تتكامل الاستخدامات التالية بشكل جيد مع التنسيق المستند إلى البيانات للحدود:
استخدِم الترميز الجغرافي للحصول على إطار العرض لمنطقة معيّنة.
طبِّق فلترة المكوّنات على طلب الترميز الجغرافي للحصول على معرّفات الأماكن الخاصة بالمناطق الإدارية من 1 إلى 4 أو الموقع الجغرافي أو الرمز البريدي.
استخدِم الترميز الجغرافي العكسي للعثور على معرّفات الأماكن من خلال إحداثيات خطوط الطول والعرض، أو حتى لعرض معرّفات الأماكن لجميع المكوّنات في موقع جغرافي معيّن.
يستخدم المثال التالي عنوانًا (تمت إزالة الأحرف الخاصة منه) لإرسال طلب إلى Geocoding API:
يمكنك استخدام الترميز الجغرافي العكسي
للعثور على معرّفات الأماكن. تعرض دالة خدمة الترميز الجغرافي التالية معرّفات الأماكن لجميع مكوّنات العنوان عند إحداثيات خط العرض وخط الطول المحدّدة:
استخدِم الترميز الجغرافي العكسي مع فلترة المكوّنات للحصول على مكوّن العنوان
لواحد أو أكثر من الأنواع التالية في الموقع الجغرافي المحدّد:
administrativeArea
country
locality
postalCode
تعرض دالة المثال التالي كيفية استخدام خدمة الترميز الجغرافي، وإضافة قيود على المكوّنات باستخدام الترميز الجغرافي العكسي للحصول على جميع مكوّنات العنوان في الموقع الجغرافي المحدّد لنوع locality فقط:
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eYou can use the Places Service and Geocoding API with the Maps SDK for Android to find place IDs for regions and get more information about them for data-driven styling.\u003c/p\u003e\n"],["\u003cp\u003eThe Places SDK for Android, Places API, and Geocoding API can be used to search for regions and retrieve their details, including place IDs, viewport, feature type, and formatted address.\u003c/p\u003e\n"],["\u003cp\u003eText Search (New) in the Places API, Places Autocomplete in the Places SDK for Android, and the Geocoding API are methods for obtaining place IDs.\u003c/p\u003e\n"],["\u003cp\u003eWhen using these services, be aware that the Places SDK for Android, Places API, and Geocoding API require enabling and are billed separately from the Maps SDK for Android.\u003c/p\u003e\n"]]],[],null,["# Use the Places Service and Geocoding API with data-driven styling for boundaries\n\nSelect platform: [Android](/maps/documentation/android-sdk/dds-boundaries/dds-use-maps-places-apis \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/dds-boundaries/dds-use-maps-places-apis \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/dds-boundaries/dds-use-maps-places-apis \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nYou can use the Places Service and the\nGeocoding API with the Maps SDK for Android to search for regions, and\nget more information about places. The Places Service\nand Geocoding API are powerful and stable alternatives for obtaining\nplace IDs. If you're already using place IDs, you can reuse those IDs with\ndata-driven styling for boundaries.\n\nAdd the Places Service and Geocoding to your\nMaps SDK for Android apps in the following ways:\n\n- [Places SDK for Android](/maps/documentation/places/android-sdk) is an Android library containing methods to returns information about places.\n- [Places API](/maps/documentation/places/web-service) returns information about places using HTTP requests.\n- [Geocoder class](https://developer.android.com/reference/android/location/Geocoder) can geocode and reverse geocode dynamically from user input.\n- [Geocoding API](/maps/documentation/geocoding) lets you geocode static, known addresses.\n\n| **Note:** The [Places SDK for Android](/maps/documentation/places/android-sdk), [Places API](/maps/documentation/places/web-service), and [Geocoding API](/maps/documentation/geocoding/cloud-setup) must be enabled, and are billed separately from the Maps SDK for Android.\n\nUse the Places Service\n----------------------\n\n### Use Text Search (New) to find a place ID\n\nYou can use [Text Search (New)](/maps/documentation/places/web-service/text-search)\nREST API in the Places API to get a place ID that includes region\ndata by specifying `places.id` in the field mask. Usage of the\nText Search (New) to request place IDs only incurs\nno charge. [Learn more](/maps/documentation/places/web-service/preview-billing).\n\nFor example, to get the place ID for Trinidad, CA you can make the following\nAPI call: \n\n```\ncurl -X POST -d '{\n \"textQuery\" : \"Trinidad, CA\"\n}' \\\n-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: \u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e' \\\n-H 'X-Goog-FieldMask: places.id' \\\n'https://places.googleapis.com/v1/places:searchText'\n```\n\n### Use Places Autocomplete to find regions\n\nThe [Places Autocomplete](/maps/documentation/places/android-sdk/autocomplete)\nservice in the Places SDK for Android provides a convenient way to let\nyour users search for regions. To configure the Places Autocomplete service to\nreturn only regions, use\n[`AutocompleteSupportFragment.setTypesFilter(List)`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/widget/AutocompleteSupportFragment#setTypesFilter(java.util.List%3Cjava.lang.String%3E))\nto set the type filter to `PlaceTypes.REGIONS`.\n\n### Get place details for a region\n\nThe [Place Details](/maps/documentation/places/android-sdk/place-details)\nservice in the Places SDK for Android returns data for a region can be\nquite useful. For example, you can:\n\n- Search for boundary place IDs based on place names.\n- Get the viewport for zooming to a boundary.\n- Get the feature type for the boundary (for example `locality`).\n- Get the formatted address, which resolves to \"Place Name, State, Country\" in the United States region (for example, \"Ottumwa, IA, USA\").\n- Get other useful data such as photos.\n\nUse the Geocoding API\n---------------------\n\nThe [Geocoding API](/maps/documentation/geocoding) lets you convert\nan address into latitude and longitude coordinates and a Place ID, or converts\nlatitude and longitude coordinates or a Place ID into an address. The following\nuses combine well with data-driven styling for boundaries:\n\n- Use Geocoding to get the viewport for a region.\n- Apply component filtering to your Geocoding call to get the place IDs for administrative areas 1-4, locality, or postal code.\n- Use reverse geocoding to find place IDs by latitude and longitude coordinates, or even return place IDs for all components in a particular location.\n\nThe following example uses an address (url-escaped) to make a request to the\nGeocoding API: \n\n```html\nhttps://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY\n```\n\nYou can use [reverse geocoding](/maps/documentation/geocoding/requests-reverse-geocoding)\nto find place IDs. The following example Geocoding\nservice function returns the place IDs for all address components at the\nspecified latitude and longitude coordinates: \n\n```html\nhttps://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY\n```\n\nUse reverse geocoding with component filtering to get the address component\nfor one or more of the following types at the specified location:\n\n- `administrativeArea`\n- `country`\n- `locality`\n- `postalCode`\n\nThe next example function shows using the Geocoding service, adding component\nrestrictions with reverse geocoding to get all of the address components at the\nspecified location for only the `locality` type: \n\n```html\nhttps://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY\n```"]]
