Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Jeśli podasz prawidłowy adres lub identyfikator filmu, metoda
lookupVideoMetadata
zwróci metadane powiązane z danym filmem. Metadane w treści odpowiedzi pozwalają określić aktualność zdjęć i długość filmu, a także zapewniają bezpłatny proces potwierdzania istnienia filmów.
Interfejs API zwraca wtedy jedną z tych 2 odpowiedzi:
Jeśli film istnieje, lookupVideoMetadata zwraca metadane filmu.
Jeśli film nie istnieje, API zwraca kod błędu 404.
Przykładowe żądanie
Przykładowy kod poniżej wysyła prośbę o film z widokiem z lotu ptaka na Transamerica Pyramid, który znajduje się pod adresem 600 Montgomery St, San Francisco, CA 94111.
Filmu nie ma w bazie danych Google. Może to być spowodowane tym, że nie została jeszcze wyrenderowana lub znajduje się w obszarze, który nie jest obsługiwany.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003elookupVideoMetadata\u003c/code\u003e method retrieves metadata for an aerial view video using a valid address or videoID.\u003c/p\u003e\n"],["\u003cp\u003eThis method helps determine video freshness, length, and confirms video existence.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns video metadata if the video exists, or a 404 error if it doesn't.\u003c/p\u003e\n"],["\u003cp\u003eYou can use a URL-encoded US postal address or a \u003ccode\u003evideoId\u003c/code\u003e to call this endpoint.\u003c/p\u003e\n"],["\u003cp\u003eIf a video isn't found in a supported area, you can initiate a render request using the \u003ccode\u003erenderVideo\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The `lookupVideoMetadata` method retrieves metadata for a given video using a URL-encoded address or videoID. A GET request is sent to the API endpoint with an API key and address. The API returns either video metadata, including ID, capture date, duration, and state, or a 404 error if the video is not found. If the video is not found and in a supported area a `renderVideo` request can be initiated. Possible states for the video include \"ACTIVE\" or \"PROCESSING\".\n"],null,["Given a valid address or videoID, the\n[`lookupVideoMetadata`](/maps/documentation/aerial-view/reference/rest/v1/videos/lookupVideoMetadata)\nmethod returns metadata associated with a given video. The metadata in the\nresponse body lets you determine the freshness of the imagery, length of the\nvideo, and also provides a free workflow for confirming the existence of videos.\n\nHow to use the API\n\nCall this endpoint by passing it a [URL-encoded](/maps/url-encoding) US postal\naddress or a\n[`videoId`](/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata). \n\n```json\ncurl -X GET \"https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=\u003cvar class=\"apiparam\" translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e&address=\u003cvar translate=\"no\"\u003ePOSTAL_ADDRESS\u003c/var\u003e\"\n```\n\nThe API then returns one of the following two responses:\n\n- If the video exists, `lookupVideoMetadata` returns the video's metadata.\n- If the video doesn't exist, the API returns a 404 error code.\n\nExample request\n\nThe following code sample requests an aerial view video for the Transamerica\nPyramid, located at 600 Montgomery St, San Francisco, CA 94111. \n\n```json\ncurl -X GET \"https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=\u003cvar class=\"apiparam\" translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111\"\n```\n\nExample response\n\nThe following JSON examples demonstrate all possible responses to the\n`lookupVideoMetadata` request.\n\nVideo found\n\nThe video has already been rendered. \n\n {\n \"videoId\": \"Ul1naoFmqo69U1zUVrQRkc\",\n \"captureDate\": {\n \"year\": 2022,\n \"month\": 4,\n \"day\": 1\n },\n \"duration\": \"40s\",\n \"state\": \"ACTIVE\"\n }\n\nVideo is rendering\n\nThe video is rendering. \n\n {\n \"videoId\": \"Ul1naoFmqo69U1zUVrQRkc\",\n \"state\": \"PROCESSING\"\n }\n\nVideo not found\n\nThe video isn't in Google's database. This could be because it either hasn't yet\nbeen rendered, or because the location is in an area that isn't supported.\n\nIf the location is in a [supported\narea](/maps/documentation/aerial-view/overview#coverage_areas), you can use\n[`renderVideo`](/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo)\nto initiate a render request. \n\n {\n \"error\": {\n \"code\": 404,\n \"message\": \"Video not found.\",\n \"status\": \"NOT_FOUND\"\n }\n }"]]
