تصویر با استفاده از پارامترهای درخواست مشخص می شود. همانطور که در URL ها استاندارد است، تمام پارامترها با استفاده از علامت علامت (&) از هم جدا می شوند. پارامترهای مجاز و مقادیر احتمالی آنها در زیر فهرست شده است.
پارامترهای مورد نیاز
یا:
location می تواند یک رشته متنی (مانند Chagrin Falls, OH ) یا یک جفت مختصات طول و عرض جغرافیایی ( 40.457375,-80.009353 ) باشد و باید با URL کدگذاری شود. بنابراین قبل از ارسال درخواست، آدرس هایی مانند "City Hall, New York, NY" را به "City+Hall, New+York, NY" تبدیل کنید. Street View Static API به عکس پانوراما نزدیکترین مکان به مکان می‌خورد. هنگامی که یک رشته متن آدرس را ارائه می کنید، API ممکن است از مکان دوربین متفاوتی برای نمایش بهتر مکان مشخص شده استفاده کند. هنگامی که مختصات طول و عرض جغرافیایی را ارائه می کنید، API شعاع 50 متری را برای نزدیکترین عکس به مکان جستجو می کند. از آنجایی که تصاویر نمای خیابان به طور دوره‌ای بازخوانی می‌شوند و ممکن است هر بار عکس‌ها از موقعیت‌های کمی متفاوت گرفته شوند، ممکن است هنگام به‌روزرسانی تصاویر، location شما به پانورامای متفاوتی تبدیل شود.
یا:
pano یک شناسه پانوراما خاص است. پانوراما ممکن است با گذشت زمان شناسه تغییر کند، بنابراین این شناسه را ادامه ندهید. در عوض، آدرس مکان یا مختصات طول و عرض جغرافیایی را ذخیره کنید تا بتوانید شناسه پانوراما را بازخوانی کنید. برای جزئیات، به بازخوانی شناسه های پانورامای حذف شده مراجعه کنید.
و همچنین:
size اندازه خروجی تصویر را بر حسب پیکسل مشخص می کند. اندازه به صورت {width}x{height} مشخص می‌شود - برای مثال، size=600x400 تصویری را با عرض 600 پیکسل و ارتفاع 400 برمی‌گرداند.
key به شما امکان می دهد استفاده از API برنامه خود را در کنسول Google Cloud نظارت کنید و اطمینان حاصل می کند که Google می تواند در صورت لزوم درباره برنامه شما با شما تماس بگیرد. برای اطلاعات بیشتر، به دریافت کلید و امضا مراجعه کنید.
شناسه های پانورامای حذف شده را بازخوانی کنید
اگر می‌خواهید یک شناسه پانوراما را بازیابی کنید و ZERO_RESULTS یا بدون مقدار دریافت کنید، شناسه پانوراما حذف شده است و باید بازخوانی شود.
آدرس مکان یا مختصات طول و عرض جغرافیایی را که برای دریافت شناسه پانوراما استفاده کرده‌اید، ذخیره کنید تا بتوانید در صورت نیاز آن را بازخوانی کنید.
وقتی متوجه شدید که شناسه پانوراما تغییر کرده است، از آدرس اصلی مکان یا مختصات طول و عرض جغرافیایی استفاده کنید تا دوباره نزدیکترین پانوراما به آن مکان را جستجو کنید و یک شناسه پانوراما جدید دریافت کنید.
پارامترهای اختیاری
signature ( توصیه می‌شود ) یک امضای دیجیتالی است که برای تأیید اینکه هر سایتی که با استفاده از کلید API شما درخواست ایجاد می‌کند مجاز به انجام این کار است استفاده می‌شود. درخواست‌هایی که شامل امضای دیجیتال نمی‌شوند ممکن است با شکست مواجه شوند. برای اطلاعات بیشتر، به دریافت کلید و امضا مراجعه کنید.
heading نشان دهنده عنوان قطب نما دوربین است. مقادیر پذیرفته شده از 0 تا 360 هستند (هر دو مقدار شمال، 90 نشان دهنده شرق و 180 جنوب). اگر عنوانی را مشخص نکنید، مقداری محاسبه می‌شود که دوربین را به سمت location مشخص شده هدایت می‌کند، از نقطه‌ای که نزدیکترین عکس گرفته شده است.
fov ( پیش‌فرض90 است) میدان دید افقی تصویر را که بر حسب درجه بیان می‌شود، با حداکثر مقدار مجاز 120 تعیین می‌کند. هنگامی که با یک درگاه دید با اندازه ثابت سروکار دارید، مانند یک تصویر نمای خیابان با اندازه تعیین شده، میدان دید در اصل بزرگنمایی را نشان می‌دهد و اعداد کوچکتر نشان‌دهنده سطح بالاتری از زوم هستند.
(چپ: fov=120 ؛ راست: fov=20 )
pitch (پیش فرض 0است ) زاویه بالا یا پایین دوربین را نسبت به وسیله نقلیه نمای خیابان مشخص می کند. این اغلب، اما نه همیشه، افقی صاف است. مقادیر مثبت زاویه دوربین را به سمت بالا (با 90 درجه نشان دهنده مستقیم به بالا) قرار می دهند. مقادیر منفی دوربین را به سمت پایین زاویه می دهند (با -90 نشان دهنده مستقیم به پایین).
radius ( پیش‌فرض50 است) شعاع مشخص شده بر حسب متر را تعیین می‌کند تا در آن یک پانوراما با محوریت طول و عرض جغرافیایی داده شده جستجو شود. مقادیر معتبر اعداد صحیح غیر منفی هستند.
return_error_code نشان می‌دهد که آیا API باید کد خطایی را زمانی که هیچ تصویری پیدا نمی‌شود (404 NOT FOUND) برگرداند یا در پاسخ به یک درخواست نامعتبر (400 BAD REQUEST). مقادیر معتبر true و false هستند. اگر روی true تنظیم شود، یک پیام خطا به جای تصویر خاکستری عمومی برگردانده می شود. این امر نیاز به برقراری تماس جداگانه برای بررسی در دسترس بودن تصویر را از بین می برد.
source (پیش فرض defaultاست ) جستجوهای نمای خیابان را به منابع انتخابی محدود می کند. مقادیر معتبر عبارتند از:
default از منابع پیش فرض برای نمای خیابان استفاده می کند. جستجو به منابع خاصی محدود نمی شود.
outdoor جستجوها را به مجموعه های فضای باز محدود می کند. مجموعه های داخلی در نتایج جستجو گنجانده نشده است. توجه داشته باشید که پانورامای فضای باز ممکن است برای مکان مشخص شده وجود نداشته باشد. همچنین توجه داشته باشید که جستجو فقط تصاویر پانوراما را در جایی برمی‌گرداند که می‌توان مشخص کرد که داخل یا خارج از خانه هستند. به عنوان مثال، PhotoSphere ها برگردانده نمی شوند زیرا معلوم نیست که در داخل یا خارج از خانه هستند.
برای مکان‌هایی که تصاویر نمای خیابان در دسترس نیستند، API استاتیک نمای خیابان یک تصویر عمومی خاکستری را با متن «متأسفیم، ما هیچ تصویری در اینجا نداریم» برمی‌گرداند، همانطور که در این مثال نشان داده شده است:
شکل: تصویر عمومی زمانی نمایش داده می شود که هیچ تصویری برای مکان مشخص شده در دسترس نباشد.
فقط تصاویر معتبر را نشان دهید
برای جلوگیری از نمایش تصویر عمومی و اطمینان از اینکه صفحه وب شما فقط تصاویر معتبر API Static View Street را نمایش می دهد، این پیشنهادات را دنبال کنید:
پارامتر return_error_code را روی true تنظیم کنید. این باعث می‌شود که API استاتیک نمای خیابان به جای تصویر خاکستری عمومی، خطای 404 NOT FOUND را برگرداند، اگر تصویری برای مکان مشخص‌شده در دسترس نباشد.
پیش از ارسال درخواست، فراداده تصویر نمای خیابان را درخواست کنید تا مشخص شود آیا تصاویری برای مکان مشخص شده در دسترس است یا خیر.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAccess Street View images via HTTP URL using specified parameters for location, size, and API key.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either a text string location like "Chagrin Falls, OH" or latitude/longitude coordinates like "40.457375,-80.009353" to specify the location for Street View image requests.\u003c/p\u003e\n"],["\u003cp\u003eCustomize Street View image requests by adjusting parameters such as \u003ccode\u003eheading\u003c/code\u003e, \u003ccode\u003efov\u003c/code\u003e, \u003ccode\u003epitch\u003c/code\u003e, and \u003ccode\u003eradius\u003c/code\u003e to control the camera's view.\u003c/p\u003e\n"],["\u003cp\u003eIf Street View imagery is unavailable for the specified location, the API returns a generic gray image, which you can prevent by using the \u003ccode\u003ereturn_error_code\u003c/code\u003e parameter or checking image metadata beforehand.\u003c/p\u003e\n"],["\u003cp\u003eTo avoid misuse, it's recommended to use a digital signature (\u003ccode\u003esignature\u003c/code\u003e parameter) with your API key, especially for former Google Maps Platform Premium Plan customers.\u003c/p\u003e\n"]]],[],null,["# Streetview request and response\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\nA Street View Image request is an HTTP URL in this format: \n\n```text\nhttps://maps.googleapis.com/maps/api/streetview?parameters\n```\n\nThe image is specified using request parameters. As is standard in\nURLs, all parameters are separated using the ampersand (\\&) character.\nAllowed parameters and their possible values are listed below.\n\nRequired parameters\n-------------------\n\nEither:\n\n- `location` can be either a text string (such as `Chagrin Falls, OH`) or a latitude and longitude coordinates pair (`40.457375,-80.009353`), and should be [URL-encoded](/maps/url-encoding). So convert addresses such as \"City Hall, New York, NY\" to \"City+Hall,New+York,NY\" before you send the request. The Street View Static API snaps to the panorama photograph closest to the location. When you provide an address text string, the API may use a different camera location to better display the specified location. When you provide latitude and longitude coordinates, the API searches a 50 meter radius for a photograph closest to the location. Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, it's possible that your `location` may snap to a different panorama when imagery is updated.\n\nOr:\n\n- `pano` is a specific panorama ID. Panoramas may change ID over time, so don't persist this ID. Instead, save the location address or latitude and longitude coordinates so you can refresh the panorama ID. For details, see [Refresh deleted panorama IDs](#refresh-pano).\n\nAs well as:\n\n- `size` specifies the output size of the image in pixels. Size is specified as `{width}x{height}` - for example, `size=600x400` returns an image 600 pixels wide, and 400 high.\n- `key` lets you monitor your application's API usage in the [Google Cloud console](https://console.cloud.google.com), and ensures that Google can contact you about your application if necessary. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n### Refresh deleted panorama IDs\n\nIf you attempt to retrieve a panorama ID and get either `ZERO_RESULTS` or\nno value, then the panorama ID has been deleted and needs to be refreshed.\n\n1. Save the location address or latitude and longitude coordinates you used to\n get a panorama ID so you can refresh when needed.\n\n2. When you detect that a panorama ID has changed, use the original location\n address or latitude and longitude coordinates to search again for the nearest\n panoramas to that location and get a new panorama ID.\n\n| **Note:** Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, a given panorama ID may snap to a different panorama when imagery or the panorama ID is updated.\n\nOptional parameters\n-------------------\n\n- `signature` (*recommended* ) is a digital signature used to verify that any site generating requests using your API key is authorized to do so. Requests that don't include a digital signature might fail. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n **Note:** for former Google Maps Platform Premium Plan customers, the **digital\n signature is required** . Get more information on\n [authentication parameters for\n Premium Plan customers](/maps/documentation/streetview/get-api-key#premium-auth).\n- `heading` indicates the compass heading of the camera. Accepted values are from `0` to `360` (both values indicating North, with `90` indicating East, and `180` South). If you don't specify a heading, a value is calculated that directs the camera towards the specified `location`, from the point at which the closest photograph was taken.\n- `fov` (*default is* `90`) determines the horizontal field of view of the image expressed in degrees, with a maximum allowed value of `120`. When dealing with a fixed-size viewport, as with a Street View image of a set size, field of view in essence represents zoom, with smaller numbers indicating a higher level of zoom.\n\n \u003cbr /\u003e\n\n\n \u003cbr /\u003e\n\n *(Left: `fov=120`; Right: `fov=20`)*\n\n\n- `pitch` (*default is* `0`) specifies the up or down angle of the camera relative to the Street View vehicle. This is often, but not always, flat horizontal. Positive values angle the camera up (with `90` degrees indicating straight up); negative values angle the camera down (with `-90` indicating straight down).\n- `radius` (*default is* `50`) sets a radius, specified in meters, in which to search for a panorama, centered on the given latitude and longitude. Valid values are non-negative integers.\n- `return_error_code` indicates whether the API should return an error code when no image is found (404 NOT FOUND), or in response to an invalid request (400 BAD REQUEST). Valid values are `true` and `false`. If set to `true`, an error message is returned in place of the generic gray image. This eliminates the need to make a separate call to check for image availability.\n- `source` (*default is* `default`) limits Street View searches to selected sources. Valid values are:\n - `default` uses the default sources for Street View; searches are not limited to specific sources.\n - `outdoor` limits searches to outdoor collections. Indoor collections are not included in search results. Note that outdoor panoramas may not exist for the specified location. Also note that the search only returns panoramas where it's possible to determine whether they're indoors or outdoors. For example, PhotoSpheres are not returned because it's unknown whether they are indoors or outdoors.\n\nThis is an example request. \n\n```html\nhttps://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE\n```\n\nNo imagery available\n--------------------\n\nFor locations where Street View imagery is not available, the Street View Static API\nreturns a gray generic image, with the text \"Sorry, we have no imagery\nhere.\", as shown in this example:\nFigure: Generic image displayed when no imagery is available for the specified location.\n\n### Show only valid images\n\nTo avoid displaying the generic image, and ensure that your web page\ndisplays only valid Street View Static API images, follow these\nsuggestions:\n\n- Set the `return_error_code` parameter to `true`. This causes the Street View Static API to return a 404 NOT FOUND error in place of the generic gray image, if no image is available for the specified location.\n- Request [Street View image metadata](/maps/documentation/streetview/metadata) to determine if there is imagery available for the specified location prior to sending a request."]]
