السياسات وبيانات المصدر الخاصة بخدمة Geocoding API
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا المستند متطلبات التطبيقات التي تم تطويرها باستخدام Geocoding API. يُرجى العِلم أنّ استخدام Geocoding API يخضع لاتفاقيتك مع Google.
السياسات
يوضّح هذا القسم السياسات ذات الصلة بواجهة Geocoding API. توفّر السياسات إرشادات ومتطلبات عملية للتنفيذ لمساعدتك في استخدام الخدمة بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".
استثناءات من القيود المفروضة على التخزين المؤقت
يُرجى العِلم أنّ معرّف المكان، المستخدَم لتعريف مكان بشكلٍ فريد، معفى منقيود التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى. يتم عرض رقم تعريف المكان في الحقل place_id ضمن الردود من واجهة برمجة التطبيقات. يمكنك التعرّف على كيفية حفظ معرّفات الأماكن وتحديثها وإدارتها في دليل معرّفات الأماكن.
بلدان ومناطق المنطقة الاقتصادية الأوروبية
يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان فوترة في المنطقة الاقتصادية الأوروبية، وقد تتوفّر فيه أيضًا وظائف مختلفة. قبل البدء في إنشاء التطبيقات باستخدام "منصة خرائط Google"، يُرجى مراجعة البنود والمعلومات التالية الخاصة بالمنطقة الاقتصادية الأوروبية:
يقدّم هذا القسم متطلبات تحديد المصدر وإرشادات عرض "خرائط Google" والمحتوى من خلال تطبيقاتك.
عرض مصدر البيانات في "خرائط Google"
يجب اتّباع متطلبات تحديد المصدر في "خرائط Google" عند عرض المحتوى من واجهات Google Maps Platform API في تطبيقك أو موقعك الإلكتروني. لا تحتاج إلى إضافة مصدر إضافي إذا كان المحتوى معروضًا على "خريطة Google" حيث يظهر المصدر.
بيانات المصدر المضمّنة في "خرائط Google"
بالنسبة إلى بيانات المصدر في "خرائط Google" التي توفّرها "منصة خرائط Google" في واجهة المستخدم، مثل Places UI Kit:
لا تزِل معلومات تحديد المصدر المضمّنة بغض النظر عن مكان عرضها. يجب عدم تعديل معلومات تحديد المصدر أو إخفاؤها أو حجبها، والتأكّد من أنّها ظاهرة بوضوح على الخلفية.
يجب دائمًا التمييز بصريًا بين "محتوى منصة خرائط Google" والمحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة البيضاء الكافية.
عند إجراء تعديلات مرئية، يجب الالتزام بجميع متطلبات الإشارة إلى المصدر في "خرائط Google".
شعار "خرائط Google" وإحالة نصية
يجب أن يكون مصدر البيانات على شكل شعار "خرائط Google" كلما أمكن ذلك. في الحالات التي تكون فيها المساحة محدودة، يكون النص خرائط Google مقبولاً. يجب أن يكون واضحًا دائمًا للمستخدمين النهائيين المحتوى الذي توفّره "خرائط Google".
على اليمين: بيان مصدر شعار "خرائط Google"، على اليسار: بيان مصدر نص "خرائط Google"
تحديد مصدر الشعار
اتّبِع هذه المتطلبات لاستخدام شعار "خرائط Google" في تطبيقك أو موقعك الإلكتروني. الأشكال المقبولة لبيان مصدر شعار "خرائط Google"
تنزيل شعارات "خرائط Google"
استخدِم ملفات شعار "خرائط Google" الرسمية. نزِّل الشعارات أدناه واتّبِع الإرشادات الواردة في هذا القسم.
اتّبِع هذه المتطلبات بشأن المعالجة المرئية لبيانات المصدر في "خرائط Google".
ضَع معلومات تحديد المصدر بالقرب من أعلى المحتوى أو أسفله، وضِمن الحاوية المرئية نفسها. بالنسبة إلى سطر واحد من المحتوى، يمكن وضع مصدر المحتوى على اليمين أو اليسار.
ميِّز بصريًا "محتوى منصة خرائط Google" عن المحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة البيضاء الكافية.
يجب عدم تقديم معلومات مضلّلة عن "خرائط Google" من خلال نسبها إلى محتوى لا يخصّ Google Maps Platform.
تأكَّد من أنّ مصدر المحتوى يظهر دائمًا بشكل واضح ويمكن قراءته. يجب عدم إزالة الشارة أو إخفائها أو تعتيمها أو تعديلها أبدًا.
تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.
مثال على بيان مصدر بيانات "خرائط Google" في أعلى المحتوى وأسفله وعلى جانبه مثال على ثلاث طرق للتمييز بين محتوى "خرائط Google" (تقييم المكان) والمحتوى الآخر لا تحجب بيان مصدر بيانات "خرائط Google" أو تخلطه بمحتوى من مصادر أخرى
مزودو بيانات الجهات الخارجية
تأتي بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات تحديد المصدر المطلوبة لمزوّد البيانات التابع لجهة خارجية. وفي هذه الحالة، يجب أن يتضمّن نص الإشارة إلى المصدر الاسم "خرائط Google" ومزوّدي البيانات المعنيين، مثل "بيانات الخرائط: Google وMaxar Technologies". عندما تقدّم Google إسنادًا إلى جهة خارجية، لا يكفي تضمين "خرائط Google" أو شعار Google فقط.
تاريخ التعديل الأخير: 2025-08-18 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eApplications using the Geocoding API must provide publicly accessible Terms of Use and a Privacy Policy, adhering to Google's guidelines.\u003c/p\u003e\n"],["\u003cp\u003eContent pre-fetching, caching, or storage is generally restricted, with the exception of place IDs, which can be stored indefinitely.\u003c/p\u003e\n"],["\u003cp\u003eGeocoding API results displayed on a map must be shown on a Google Map, and attribution is required when displaying data without a Google Map.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides guidelines for displaying its logo and attribution text, emphasizing proper placement, legibility, and adherence to branding.\u003c/p\u003e\n"],["\u003cp\u003eClear space, legibility, and color considerations are essential for Google attribution, along with specific font and CSS recommendations for optimal display.\u003c/p\u003e\n"]]],["Geocoding API applications must include publicly available Terms of Use and a Privacy Policy, referencing Google's terms and policies. Content, except for the place ID, should not be pre-fetched, cached, or stored without agreement. Results can be displayed on or off a Google Map, but must use a Google Map if displayed on one. When data is displayed with or without a map a Google logo is needed, it cannot be altered. Clear attribution is also required, including third-party data providers.\n"],null,["This document lists requirements for applications developed with the\nGeocoding API. Note that use of the Geocoding API is governed by\nyour Agreement with Google.\n\nPolicies\n\nThis section describes policies relevant to Geocoding API. Policies provide practical\nimplementation guidelines and requirements to help you use the Service\ncorrectly and in line with Google Maps Platform's expectations.\n\nExceptions from caching restrictions\n\nNote that the **place ID** , used to uniquely identify a place, is\n**exempt from** the [caching restrictions](https://cloud.google.com/maps-platform/terms/maps-service-terms).\nYou can therefore store place ID values indefinitely.\nThe place ID is returned in the `place_id` field in\nAPI responses. Learn how to save, refresh, and manage place IDs in the [Place IDs guide](/maps/documentation/geocoding/place-id#save-id).\n\nEuropean Economic Area countries and territories\n\nThis product has different Terms of Service for customers with a billing address in the\nEuropean Economic Area (EEA), and it may also have different functionality.\nBefore building with Google Maps Platform, review the following EEA-specific\nterms and information:\n\n- [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea)\n- [Google Maps Platform EEA Service Specific Terms](https://cloud.google.com/terms/maps-platform/eea/maps-service-terms)\n- [EEA frequently asked questions (FAQ)](/maps/comms/eea/faq)\n- [Google Maps Platform Road Safety Requirements](https://cloud.google.com/terms/maps-platform/eea-safety-requirements)\n\nIf your billing address is not in the EEA, the following terms of service apply to you:\n\n- [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms)\n- [Google Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms)\n\nGoogle Maps attribution requirements\n\nThis section provides attribution requirements and guidelines for displaying Google\nMaps and Content through your applications.\n\nDisplay Google Maps attribution\n\nYou must follow Google Maps attribution requirements when displaying Content from\nGoogle Maps Platform APIs in your app or website. You don't need to add extra attribution\nif the Content is shown on a Google Map where the attribution is already visible.\n\nIncluded Google Maps attribution\n\nFor Google Maps attribution that is already provided by Google Maps Platform in\nthe user interface, such as in Places UI Kit:\n\n- Don't remove included attribution regardless of where it is displayed. Don't alter, hide, or obscure the attribution and make sure it is clearly visible against the background.\n- Always visually distinguish Google Maps Platform Content from other content by using UI cues such as a border, background color, shadow, or sufficient whitespace.\n- When making visual modifications, you must adhere to all Google Maps attribution requirements.\n\nGoogle Maps logo and text attribution\n\nAttribution should take the form of the Google Maps logo whenever possible.\nIn cases where space is limited, the text **Google Maps** is acceptable.\nIt must always be clear to end users which content is provided by Google Maps.\nLeft: Google Maps logo attribution, Right: Google Maps text attribution\n\nLogo attribution Follow these requirements for using the Google Maps logo in your app or website. Acceptable variations for Google Maps logo attribution\n\nDownload Google Maps logos\n\nUse the official Google Maps logo files. Download the logos below, and follow the guidelines in this section.\n[Download the Google Maps attribution assets](/static/maps/documentation/images/Google_Maps_Attribution_Assets.zip)\n\nWhen using the Google Maps logo, follow these guidelines.\n\n- Don't modify the logo in any way.\n- Maintain the aspect ratio of the logo to prevent distortion.\n- Use the outlined logo on a busy background, like a map or image.\n- Use the non-outlined logo on a plain background, like a solid color or subtle gradient.\n\nLogo size specification Follow these size specifications for the Google Maps logo:\n\n- **Minimum logo height:** 16dp\n- **Maximum logo height:** 19dp\n- **Minimum logo clear space:** 10dp on left, right and top, 5dp on the bottom\n\nTo learn about dp, see [Pixel density](https://m2.material.io/design/layout/pixel-density.html#pixel-density) on the Material Design website.\nGoogle Maps logo showing minimum clear space and acceptable size range\n\nLogo accessibility Follow these accessibility requirements for the Google Maps logo:\n\n- Maintain an [accessible contrast](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html) between the logo and the background.\n- Include an accessibility label with the text **Google Maps**.\n\nUnacceptable variations and accessibility issues for Google Maps logo attribution\n\nText attribution\n\nIf the size of your interface does not support using the Google Maps logo, you can spell out **Google Maps** in text. Follow these guidelines:\nAcceptable variations of the Google Maps text attribution\n\n- Don't modify the text **Google Maps** in any way: \n - Don't change the capitalization of **Google Maps**\n - Don't wrap **Google Maps** onto multiple lines\n - Don't localize **Google Maps** into another language.\n - Prevent browsers from translating **Google Maps** by using the HTML attribute `translate=\"no\"`.\n\nUnacceptable variations of the Google Maps text attribution\n\n- Style Google Maps text as described in the following table:\n\n | Google Maps text-styling requirements ||\n |----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | **Property** | **Style** |\n | Font family | [Roboto](https://fonts.google.com/specimen/Roboto?preview.text_type=custom). Loading the font is optional. |\n | Fallback font family | Any sans serif body font already used in your product or \"Sans-Serif\" to invoke the default system font |\n | Font style | Normal |\n | Font weight | 400 |\n | Font color | White, black (#1F1F1F), or gray (#5E5E5E). Maintain accessible [(4.5:1)](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html) contrast against the background. |\n | Font size | Minimum font size: 12sp Maximum font size: 16sp To learn about sp, see [Font size units](https://m3.material.io/styles/typography/type-scale-tokens#3f4488e7-3b74-45b0-a143-9d6afa4d62dc) on the Material Design website. |\n | Letter spacing | Normal |\n\nExample CSS\n\nThe following CSS renders Google Maps with the appropriate typographic style and color on a white or light background. \n\n```python\n@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');\n\n.GMP-attribution {\nfont-family: Roboto, Sans-Serif;\nfont-style: normal;\nfont-weight: 400;\nfont-size: 1rem;\nletter-spacing: normal;\nwhite-space: nowrap;\ncolor: #5e5e5e;\n}\n```\n\nVisual requirements Follow these requirements for the visual treatment of Google Maps attribution.\n\n- Position attribution near the top or bottom of the content, and within the same visual container. For a single line of content, attribution can be positioned to the right or left.\n\n- Visually distinguish Google Maps Platform Content from other content by using UI cues such as a border, background color, shadow, or sufficient whitespace.\n\n- Don't misrepresent Google Maps by attributing it with non-Google Maps Platform content.\n- Verify that the attribution is always visible and legible. Never remove, hide, obscure, or modify it.\n\nThe following figures show examples of these visual requirements.\nExample of Google Maps attribution positioned at the top, at the bottom, and to the side of the content \nExample of three approaches to differentiating Google Maps Content (the place rating) from other content \nDon't obscure the Google Maps attribution or mix it with content from other sources\n\nThird-party data providers\n\nSome of the data and images on our mapping products come from providers other than Google.\nFor some products, such as Map Tiles API, we may provide you with the required attribution\nto the third-party data provider. When we do, the text of your\nattribution must say the name \"Google Maps\" and the relevant\ndata provider(s), such as \"Map data: Google, Maxar Technologies.\" When Google provides\nthird-party attribution, only including \"Google Maps\" or the Google logo is not\nproper attribution."]]
