استخدام Places APIs وGeocoding مع تنسيق مستند إلى البيانات للحدود
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
JavaScript
المطوّرون في المنطقة الاقتصادية الأوروبية
يمكنك استخدام Places SDK لنظام التشغيل iOS وGeocoding API مع Maps SDK لنظام التشغيل iOS للبحث عن مناطق والحصول على مزيد من المعلومات حول الأماكن. تُعدّ حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS وGeocoding API بديلَين قويَّين ومستقرَّين للحصول على معرّفات الأماكن. إذا كنت تستخدم معرّفات الأماكن، يمكنك إعادة استخدامها مع ميزة "تحديد الأنماط المستند إلى البيانات" للحدود.
يمكنك إضافة Places API وGeocoding API إلى تطبيقاتك التي تستخدم "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google" لنظام التشغيل iOS بالطرق التالية:
- تعرض Places SDK for iOS معلومات عن الأماكن باستخدام طلبات HTTP.
- يمكن لفئة CLGeocoder تحويل الترميز الجغرافي والترميز الجغرافي العكسي ديناميكيًا من إدخال المستخدم.
- تتيح لك Geocoding API ترميز المواقع الجغرافية لعناوين ثابتة ومعروفة.
استخدام Places API
تعرض خدمة Places API Text Search معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في نيويورك" أو "متاجر أحذية بالقرب من أوتاوا" أو "123 شارع مين". تستجيب الخدمة بقائمة بالأماكن التي تتطابق مع السلسلة النصية وأي تحيّز للموقع الجغرافي تم ضبطه.
توفّر خدمة الإكمال التلقائي للأماكن طريقة سهلة تتيح للمستخدمين البحث عن مناطق. لعرض النتائج ضمن المنطقة المحدّدة، اضبط locationRestriction على GMSAutocompleteFilter.
الحصول على تفاصيل مكان لمنطقة معيّنة
استخدام Geocoding API
تتيح لك Geocoding API تحويل عنوان أو إحداثيات خطوط الطول والعرض أو معرّف مكان إلى إحداثيات جغرافية، والعكس صحيح. يمكن استخدام ما يلي مع ميزة "تحديد الأنماط المستند إلى البيانات" للحدود:
- استخدِم الترميز الجغرافي للحصول على إطار العرض لمنطقة معيّنة.
- طبِّق فلترة المكوّنات على طلب Geocoding للحصول على معرّفات الأماكن الخاصة بالمناطق الإدارية من 1 إلى 4 أو المنطقة المحلية أو الرمز البريدي.
- استخدِم الترميز الجغرافي العكسي للعثور على معرّفات الأماكن من خلال إحداثيات خطوط الطول والعرض، أو حتى لعرض معرّفات الأماكن لجميع المكوّنات في موقع جغرافي معيّن.
يستخدم المثال التالي عنوانًا (تمت إزالة الأحرف الخاصة منه) لإرسال طلب إلى Geocoding API:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
يمكنك استخدام ترميز جغرافي عكسي للعثور على أرقام تعريف الأماكن. تعرض دالة خدمة الترميز الجغرافي التالية معرّفات الأماكن لجميع مكوّنات العنوان عند إحداثيات خط العرض وخط الطول المحدّدة:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY
استخدِم الترميز الجغرافي العكسي مع فلترة المكوّنات للحصول على مكوّن العنوان
لواحد أو أكثر من الأنواع التالية في الموقع الجغرافي المحدّد:
administrativeAreacountrylocalitypostalCodeschoolDistrict
يعرض المثال التالي استخدام خدمة الترميز الجغرافي، وإضافة قيود على المكوّنات باستخدام الترميز الجغرافي العكسي لاسترداد جميع مكوّنات العنوان في الموقع الجغرافي المحدّد للنوع locality:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eYou can search for and get information about regions using the Places SDK for iOS and the Geocoding API with the Maps SDK for iOS.\u003c/p\u003e\n"],["\u003cp\u003eThe Places API Text Search and Autocomplete service enable searching for regions based on text strings and user input.\u003c/p\u003e\n"],["\u003cp\u003ePlace Details provide comprehensive information about regions, including boundary place IDs, viewport for zooming, and feature type.\u003c/p\u003e\n"],["\u003cp\u003eThe Geocoding API facilitates converting addresses and coordinates into geographic coordinates and vice-versa, useful for retrieving viewport, place IDs, and address components.\u003c/p\u003e\n"],["\u003cp\u003eReverse geocoding with the Geocoding API allows finding place IDs based on latitude and longitude coordinates and applying component filtering for specific address types.\u003c/p\u003e\n"]]],[],null,["Select 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\n**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\nYou can use the Places SDK for iOS and the\nGeocoding API with the Maps SDK for iOS to\nsearch for regions, and get more information about places. The\nPlaces SDK for iOS and Geocoding API\nare powerful and stable alternatives for obtaining [place\nIDs](/maps/documentation/places/ios-sdk/place-id). If you're already using place\nIDs, you can reuse those IDs with data-driven styling for boundaries.\n\nAdd Places and Geocoding to your Maps SDK for iOS apps in the following ways:\n\n- [Places SDK for iOS](/maps/documentation/places/ios-sdk) returns information about places using HTTP requests.\n- [CLGeocoder](https://developer.apple.com/documentation/corelocation/clgeocoder) class 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 iOS](/maps/documentation/places/ios-sdk) and Geocoding API must be enabled, and are billed separately from the Maps SDK for iOS.\n\nUse the Places API\n\n- The [Places API Text\n Search](/maps/documentation/places/web-service/text-search) returns\n information about a set of places based on a string --- for example \"pizza in\n New York\" or \"shoe stores near Ottawa\" or \"123 Main Street\". The service\n responds with a list of places matching the text string and any location\n bias that has been set.\n\n- The [Places Autocomplete](/maps/documentation/places/ios-sdk/autocomplete#restrict_results_to_a_specific_region) service provides a convenient\n way to let your users search for regions. To display results within the\n defined region, set `locationRestriction` on\n [`GMSAutocompleteFilter`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSAutocompleteFilter).\n\nGet place details for a region\n\n- The [Place Details](/maps/documentation/places/ios-sdk/place-details) data\n for a region is also effective. 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, \"Kirkland, WA, USA\").\n - Get other useful data such as photos.\n\nUse the Geocoding API\n\n- The [Geocoding API](/maps/documentation/geocoding) lets you\n convert an address, latitude and longitude coordinates, or place ID into\n geographic coordinates, and vice-versa. The following uses combine well with\n 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\n The following example uses an address (url-escaped) to make a request to the\n Geocoding API: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY\n ```\n\n You can use [reverse\n geocoding](/maps/documentation/geocoding/requests-reverse-geocoding) to\n find place IDs. The following example Geocoding service function returns the\n place IDs for all address components at the specified latitude and longitude\n coordinates: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY\n ```\n\n Use reverse geocoding with component filtering to get the address component\n for one or more of the following types at the specified location:\n - `administrativeArea`\n - `country`\n - `locality`\n - `postalCode`\n - `schoolDistrict`\n\n The following example shows using the Geocoding service, adding component\n restrictions with reverse geocoding to retrieve all address components\n at the specified location for the `locality` type: \n\n ```html\n https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY\n ```"]]
