تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Aerial View API هي خدمة تتيح لك إنشاء فيديوهات ثلاثية الأبعاد واقعية من الجو وعرضها لأي عنوان فعلي داخل الولايات المتحدة. تحاكي الفيديوهات لقطات تم التقاطها بواسطة طائرة بدون طيار تحلّق في الأعلى.
أنشأت Google مجموعة بيانات تتضمّن فيديوهات مُسبقة العرض للصور الجوية لتتمكّن من استخدامها. وهي تغطي المباني الكبيرة والمعالم البارزة في جميع أنحاء الولايات المتحدة.
ونحن نعمل على إضافة المزيد من الفيديوهات التي تعرض مناظر جوية باستمرار. يمكنك ببساطة استخدام هذه الفيديوهات الحالية، أو يمكنك طلب أن تنشئ Google فيديو جديدًا لك إذا لم يتوفّر فيديو لعنوان معيّن.
أسباب استخدام Aerial View API
في ما يلي بعض الأسباب التي قد تجعلك تستخدم Aerial View API.
تريد استكشاف بيانات ثلاثية الأبعاد، ولكنّك لا تشعر بالارتياح عند استخدام 3D Tiles أو العمل مع أداة عرض
يعجبك سياق صور الأقمار الصناعية، والقدرة على التعرّف على واجهة مبنى من "التجوّل الافتراضي"
لقد فكّرت في الاستعانة بمشغّل طائرات بدون طيار لتصوير مكان الإقامة
أنّك تريد استخدام تكنولوجيا مبتكرة ومتطوّرة
إذا كنت معتادًا على تضمين الفيديوهات في موقعك الإلكتروني
الإجراءات التي يمكنك تنفيذها باستخدام Aerial View API
في ما يلي قائمة ببعض الإجراءات التي يمكنك تنفيذها باستخدام Aerial View API.
توفير معلومات شاملة عن مبنى من خلال إبراز الطرق أو المتنزّهات أو المسطحات المائية القريبة
إعطاء المستأجر أو المشتري المحتمل فكرة عن شكل العقار
تحديد المشهد في فيديو قصير يعرض للمشاهد المكان الذي تتواجد فيه
إبراز المعالم السياحية أو نقاط الاهتمام عند مساعدة المستخدمين في التخطيط لعطلة
مساعدة سائقي التوصيل أو المتسوّقين في العثور على مكان عملك
طريقة عمل Aerial View API
هناك طريقتان يمكنك اتّباعهما لاستخدام Aerial View API.
الطريقة
الأسباب
البحث عن فيديو تم إنشاؤه
لقد عرضت Google مسبقًا جميع صور الجو التي تحتاج إليها (مجموعة البيانات التي عرضتها Google مسبقًا).
إنشاء فيديو جديد
تحتاج إلى صور جوية لم يسبق أن عرضتها Google مسبقًا.
مناطق التغطية
تتيح Aerial View API استخدام العناوين البريدية في الولايات المتحدة فقط، حيث يمكن لـ Google عرض فيديوهات ثلاثية الأبعاد.
كيفية استخدام Aerial View API
1
مراجعة بنود خدمة "منصة خرائط Google"
يُرجى العلم أنّه لا يمكنك تنزيل فيديوهات العرض الجوي أو تخزينها أو تخزينها مؤقتًا.
لمزيد من المعلومات، يُرجى الاطّلاع على
بنود خدمة "منصة خرائط Google".
أرسِل عنوانًا بريديًا أمريكيًا أو videoId إلى نقطة النهاية lookupVideoMetadata() لعرض البيانات الوصفية الخاصة بفيديو يقدّم عرضًا جويًا.
يمكنك الاطّلاع على استرداد البيانات الوصفية لفيديو.
4
استرداد فيديو حالي لتصوير جوّي
أرسِل عنوانًا بريديًا أمريكيًا أو videoId إلى نقطة النهاية lookupVideo() لعرض فيديو مُسبَق العرض لمنظر جوي.
اطّلِع على جلب فيديو تم إنشاؤه.
5
إنشاء فيديو جديد يقدّم عرضًا جويًا
أرسِل عنوانًا بريديًا أمريكيًا إلى نقطة النهاية renderVideo() لطلب إنشاء فيديو جديد يعرض منظرًا جويًا للعنوان المحدّد.
اطّلِع على إنشاء فيديو جديد.
تاريخ التعديل الأخير: 2025-07-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Aerial View API lets you create and display photorealistic 3D aerial videos of US addresses, simulating drone footage.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides a pre-rendered video dataset for many locations, or you can request new videos to be generated.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to enhance user experiences with interactive 3D aerial views for various applications, such as real estate, travel planning, and business listings.\u003c/p\u003e\n"],["\u003cp\u003eAccess and display videos through the API, but note that downloading or storing them locally is not permitted.\u003c/p\u003e\n"],["\u003cp\u003eThe API is limited to US addresses where 3D video rendering is supported by Google.\u003c/p\u003e\n"]]],[],null,["The Aerial View API is a service that lets you create and display\nphotorealistic 3D aerial videos of any physical address within the United\nStates. The videos simulate footage taken by a drone circling overhead.\n\nGoogle has already created a dataset of pre-rendered aerial view videos for you\nto use. They cover large buildings and landmarks throughout the United States.\nAnd we're adding more aerial view videos all the time. You can simply use these\nexisting videos or, if a video does not yet exist for an address, you can\nrequest that Google generate a new one for you.\n| **Note:** Google automatically pre-renders videos for addresses periodically, so some addresses will have no wait time.\n\nWhy use Aerial View API\n\nHere are some reasons why you might want to use Aerial View API.\n\n- You want to explore 3D data, but you're not comfortable using 3D Tiles, or with working with a renderer\n\n- You like the context of satellite imagery, and the ability to recognize a building facade from Street View\n\n- You've considered hiring a drone operator to film your property\n\n- You want to use cutting-edge, innovative technology\n\n- You're comfortable embedding video in your web site\n\nWhat you can do with Aerial View API\n\nHere's a list of some of the things you can do with Aerial View API.\n\n- Provide birds-eye awareness of a building by highlighting nearby roads, parks, or bodies of water\n\n- Give a prospective renter or home buyer a sense of what a property is like\n\n- Set the scene for a short-form video showing the viewer where you are\n\n- Highlight attractions or points-of-interest when helping users plan a vacation\n\n- Help delivery drivers or shoppers find your place of business\n\nHow the Aerial View API works\n\nThere are two approaches that you can take to use the Aerial View API.\n| **Tip:** Both of these approaches should begin with you checking whether the video exists using the [`lookupVideoMetadata`](/maps/documentation/aerial-view/lookup-video-metadata) endpoint.\n\n| Approach | Rationale |\n|--------------------------|--------------------------------------------------------------------------------------------------------------|\n| Lookup a generated video | All of the aerial imagery that you need has already been rendered by Google (Google's pre-rendered dataset). |\n| Generate a new video | You need aerial view imagery that hasn't already been pre-rendered by Google. |\n\nCoverage areas\n\nAerial View API only supports postal addresses in the United States where\nGoogle is able to render 3D videos.\n\nHow to use the Aerial View API\n\n|---|------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Review the Google Maps Platform Terms of Service** | Note that you cannot download, store, or cache the aerial view videos. For more information, see the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms/). |\n| 2 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/aerial-view/cloud-setup) and complete the instructions that follow. |\n| 3 | **Retrieve an aerial view video's metadata** | Send a US postal address or `videoId` to the `lookupVideoMetadata()` endpoint to return an aerial view video's metadata. See [Retrieve a video's metadata.](/maps/documentation/aerial-view/lookup-video-metadata) |\n| 4 | **Fetch an existing aerial view video** | Send a US postal address or `videoId` to the `lookupVideo()` endpoint to return a pre-rendered aerial view video. See [Fetch a generated video.](/maps/documentation/aerial-view/lookup-video) |\n| 5 | **Generate a new aerial view video** | Send a US postal address to the `renderVideo()` endpoint to request the generation of a new aerial view video for the specified address. See [Generate a new video.](/maps/documentation/aerial-view/generate-video) |"]]
