Migración de campos de Places (open_now y utc_offset)
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los campos opening_hours.open_now y utc_offset de Places dejaron de estar disponibles el 20 de noviembre de 2019 y se desactivaron el 20 de febrero de 2021. Estos campos dejaron de estar disponibles SOLO en la biblioteca de Places de la API de Maps JavaScript. En esta guía, se muestra cómo actualizar el código para dejar de usar estos campos.
Campo opening_hours.open_now
En esta sección, se muestra cómo actualizar esta funcionalidad para cada tipo de solicitud de Places.
Para las solicitudes de Place Details, en lugar de solicitar opening_hours.open_now en el parámetro de solicitud fields, incluye opening_hours y utc_offset_minutes en el parámetro de solicitud fields. Luego, llama al método opening_hours.isOpen() en el objeto google.maps.places.PlaceResult devuelto para verificar si el lugar está abierto. En el siguiente ejemplo, se muestra una solicitud de Place Details que determina si un lugar está abierto:
newgoogle.maps.places.PlacesService(attrContainer).getDetails({placeId:'...',fields:['opening_hours','utc_offset_minutes'],},function(place,status){if(status!=='OK')return;// something went wrongconstisOpenAtTime=place.opening_hours.isOpen(newDate('December 17, 2020 03:24:00'));if(isOpenAtTime){// We know it's open.}constisOpenNow=place.opening_hours.isOpen();if(isOpenNow){// We know it's open.}});
Solicitudes de Find Place
En el caso de las solicitudes de Find Place, no hay ningún reemplazo para el campo opening_hours.open_now. Te recomendamos realizar una solicitud de Place Details para obtener información de opening_hours.
Solicitudes de Nearby Search y Text Search
Para las solicitudes de Nearby Search y Text Search, puedes usar el parámetro de solicitud openNow, que filtra los resultados para que incluyan solo los lugares abiertos en ese momento.
openNow:false devuelve todos los lugares.
openNow:true devuelve solo los lugares que están abiertos en ese momento.
Para que se muestren todos los lugares Y se indique el estado openNow, primero usa openNow:false para realizar una solicitud y obtener todos los lugares y, luego, usa openNow:true para obtener solo los lugares abiertos. A continuación, combina las respuestas.
Campo utc_offset
En las solicitudes de Place Details, el campo utc_offset_minutes reemplazó al campo utc_offset. Simplemente reemplaza los casos de utc_offset por utc_offset_minutes en el parámetro de solicitud fields y cuando leas esta información de PlaceResult.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-27 (UTC)"],[[["\u003cp\u003eThe Places fields \u003ccode\u003eopening_hours.open_now\u003c/code\u003e and \u003ccode\u003eutc_offset\u003c/code\u003e are deprecated and will be turned off on February 20, 2021 in the Places Library, Maps JavaScript API.\u003c/p\u003e\n"],["\u003cp\u003eFor Place Details requests, use the \u003ccode\u003eopening_hours.isOpen()\u003c/code\u003e method and include \u003ccode\u003eopening_hours\u003c/code\u003e and \u003ccode\u003eutc_offset_minutes\u003c/code\u003e in the \u003ccode\u003efields\u003c/code\u003e request parameter instead of \u003ccode\u003eopening_hours.open_now\u003c/code\u003e and \u003ccode\u003eutc_offset\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor Find Place requests, it is recommended to make a Place Details request to get \u003ccode\u003eopening_hours\u003c/code\u003e information.\u003c/p\u003e\n"],["\u003cp\u003eFor Nearby Search and Text Search requests, use the \u003ccode\u003eopenNow\u003c/code\u003e request parameter to filter results based on open/closed status.\u003c/p\u003e\n"],["\u003cp\u003eReplace \u003ccode\u003eutc_offset\u003c/code\u003e with \u003ccode\u003eutc_offset_minutes\u003c/code\u003e in Place Details requests for the UTC offset information.\u003c/p\u003e\n"]]],[],null,["# Place Field Migration (open_now, utc_offset)\n\n\u003cbr /\u003e\n\nThe Places fields `opening_hours.open_now` and `utc_offset` are deprecated as\nof November 20, 2019, and will be turned off on\nFebruary 20, 2021. These fields are deprecated ONLY in the\nPlaces Library, Maps JavaScript API. This guide shows you how to update your code to\nstop using these fields.\n\n`opening_hours.open_now` field\n------------------------------\n\nThis section shows how to update this functionality for each type of Places\nrequest.\n\n### Place Details requests\n\nThe `opening_hours.open_now` field is replaced by the\n[`opening_hours.isOpen()`](/maps/documentation/javascript/reference/places-service#PlaceOpeningHours)\nmethod. \n\nFor [Place Details requests](/maps/documentation/javascript/places#place_details_requests),\ninstead of requesting `opening_hours.open_now` in the `fields` request\nparameter, include `opening_hours` and `utc_offset_minutes` in the `fields`\nrequest parameter, then call the `opening_hours.isOpen()` method on the returned\n`google.maps.places.PlaceResult` object to check whether the place is open. The\nfollowing example shows a Place Details request that determines whether a place\nis open: \n\n new google.maps.places.PlacesService(attrContainer).getDetails({\n placeId: '...',\n fields: ['opening_hours','utc_offset_minutes'],\n }, function (place, status) {\n if (status !== 'OK') return; // something went wrong\n const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));\n if (isOpenAtTime) {\n // We know it's open.\n }\n\n const isOpenNow = place.opening_hours.isOpen();\n if (isOpenNow) {\n // We know it's open.\n }\n });\n\n### Find Place requests\n\nFor [Find Place requests](/maps/documentation/javascript/places#find_place_requests),\nthere is no replacement for the `opening_hours.open_now` field. We recommend\nmaking a [Place Details request](/maps/documentation/javascript/places#place_details_requests)\nto get `opening_hours` information.\n\n### Nearby Search \\& Text Search requests\n\nFor Nearby Search and Text Search requests, you can use the [`openNow`](/maps/documentation/javascript/reference/places-service#PlaceSearchRequest)\nrequest parameter, which has the effect of filtering results to include only\nplaces that are currently open.\n\n- `openNow:false` returns all places.\n- `openNow:true` returns only places that are currently open.\n\nTo list all places AND indicate `openNow` status, first make a request using\n`openNow:false` to get all places, then make a request using `openNow:true` to\nget open places only. Then, merge the responses.\n\n`utc_offset` field\n------------------\n\nIn Place Details requests, the `utc_offset` field is replaced by the\n`utc_offset_minutes` field. Simply replace occurrences of `utc_offset` with\n`utc_offset_minutes` in the `fields` request parameter, and when reading this\ninformation from `PlaceResult`."]]
