احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به
مقدمه REST مراجعه کنید.
ProximityInfo
یک معیار نزدیکی نقطه جغرافیایی و شعاع تعیین می کند که چه منطقه جغرافیایی را شامل می شود. آدرس، توصیفی از نقطه جغرافیایی است که بر ارائه آگهی تأثیری ندارد.
دو راه برای ایجاد مجاورت وجود دارد. ابتدا با تنظیم آدرس و شعاع. نقطه جغرافیایی به طور خودکار محاسبه می شود. دوم، با تنظیم نقطه جغرافیایی و شعاع. آدرس یک برچسب اختیاری است که تأیید نمی شود.
فیلدها |
---|
geoPoint | object ( GeoPointInfo ) طول و عرض جغرافیایی. |
radiusUnits | enum ( ProximityRadiusUnits ) واحد اندازه گیری شعاع. پیش فرض KILOMETER است. |
address | object ( AddressInfo ) آدرس کامل |
radius | number شعاع مجاورت. |
GeoPointInfo
نقطه جغرافیایی برای معیار مجاورت.
نمایندگی JSON |
---|
{
"longitudeInMicroDegrees": integer,
"latitudeInMicroDegrees": integer
} |
فیلدها |
---|
longitudeInMicroDegrees | integer درجه میکرو برای طول جغرافیایی. |
latitudeInMicroDegrees | integer درجه میکرو برای عرض جغرافیایی. |
واحدهای شعاع مجاورت
واحد فاصله شعاع در مجاورت (مثلا MILES)
Enums |
---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
MILES | مایل |
KILOMETERS | کیلومتر |
آدرس اطلاعات
نمایندگی JSON |
---|
{
"postalCode": string,
"provinceCode": string,
"countryCode": string,
"provinceName": string,
"streetAddress": string,
"streetAddress2": string,
"cityName": string
} |
فیلدها |
---|
postalCode | string کد پستی |
provinceCode | string کد استان یا ایالت |
countryCode | string کد کشور |
provinceName | string نام استان یا ایالت |
streetAddress | string آدرس خیابان خط 1. |
streetAddress2 | string آدرس خیابان خط 2. این فیلد فقط برای نوشتن است. این فقط برای محاسبه طول و عرض جغرافیایی یک آدرس استفاده می شود که geoPoint خالی باشد. |
cityName | string نام شهر. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-07 بهوقت ساعت هماهنگ جهانی."],[[["Proximity criterion is used to target ads based on a geographical area defined by a radius around a specific point."],["You can define the proximity by providing an address and radius, which automatically calculates the geo point, or by specifying the geo point and radius directly."],["The address serves as a descriptive label and does not impact ad serving."],["The radius can be specified in either miles or kilometers."],["GeoPointInfo provides latitude and longitude, while AddressInfo includes address details such as postal code, country code, and street address."]]],["Proximity can be defined using a geo point and radius, or an address and radius. A geo point, represented by latitude and longitude in micro-degrees, specifies the location. The radius, defined by a number, can use kilometers or miles as the unit of measurement. An optional address, comprising details like postal code, city, and street address, serves as a description. The address will automatically calculate the geopoint if not given.\n"]]