{ "openapi": "3.0.3", "info": { "title": "Google Maps Timezone & Local Time Lookup (server mode)", "version": "1.1", "description": "Send one lookup and get the results back in the response. It takes the same input as a normal run: query parameters with GET, or a JSON body with POST. At most 30 results and 240 seconds per request; start a normal run for bigger jobs. Requests run in your own Apify account at the Actor's normal price.", "x-oa-server-mode": "1.1" }, "paths": { "/": { "get": { "operationId": "lookupGet", "summary": "Run one lookup (query parameters)", "parameters": [ { "name": "mode", "in": "query", "required": false, "description": "Coordinates resolves latitude/longitude pairs. Place looks up an address, landmark or business name. Place ID resolves a Google Place ID or Maps URL. Mixed processes every filled list in one run.", "schema": { "type": "string", "enum": [ "coordinates", "place", "placeId", "mixed" ] }, "example": "coordinates" }, { "name": "location", "in": "query", "required": false, "description": "One coordinate as {\"lat\": 40.7128, \"lng\": -74.006}. Decimal degrees, WGS84. (GET: pass it as JSON.)", "content": { "application/json": { "schema": { "type": "object" }, "example": { "lat": 40.7128, "lng": -74.006 } } } }, { "name": "locations", "in": "query", "required": false, "description": "A list of coordinates, each {\"lat\": 40.7128, \"lng\": -74.006}. (GET: pass it as JSON.)", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" }, "maxItems": 10 } } } }, { "name": "address", "in": "query", "required": false, "description": "One address, landmark, business name or postcode. Example: Eiffel Tower, Paris.", "schema": { "type": "string" } }, { "name": "addresses", "in": "query", "required": false, "description": "One address, landmark, business name or postcode per line. (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "style": "form", "explode": true }, { "name": "placeId", "in": "query", "required": false, "description": "One Google Place ID (starts with ChIJ) or a full Google Maps place URL.", "schema": { "type": "string" } }, { "name": "placeIds", "in": "query", "required": false, "description": "One Google Place ID or Google Maps place URL per line. (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "style": "form", "explode": true }, { "name": "language", "in": "query", "required": false, "description": "Language Google Maps uses for returned place names, addresses and country names. It does not translate the query itself.", "schema": { "type": "string", "enum": [ "en", "en-GB", "de", "fr", "es", "es-419", "it", "pt-BR", "pt-PT", "nl", "pl", "sv", "da", "no", "fi", "cs", "sk", "hu", "ro", "bg", "el", "tr", "ru", "uk", "ar", "he", "hi", "th", "vi", "id", "ms", "ja", "ko", "zh-CN", "zh-TW" ], "default": "en" } }, { "name": "country", "in": "query", "required": false, "description": "Optional ISO 3166-1 alpha-2 country code. The country name is added to place and address queries so an ambiguous search resolves in that country first. Leave empty for no bias. Coordinates are unaffected.", "schema": { "type": "string", "enum": [ "", "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ], "default": "" } } ], "responses": { "200": { "description": "The results as a JSON array (at most 30). They are also saved to the run's dataset and billed per result, like a normal run.", "headers": { "X-Item-Count": { "schema": { "type": "integer" }, "description": "Results returned." }, "X-Status-Message": { "schema": { "type": "string" }, "description": "The Actor's last status message, e.g. why nothing was found." } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "example": [ { "recordType": "timezone", "mode": "coordinates", "resolved": true, "language": "en", "scrapedAt": "2026-11-10T15:34:06.180049+00:00", "inputLocation": { "lat": 40.7128, "lng": -74.006 }, "placeName": "Chambers St", "formattedAddress": "Chambers St, New York, NY 10007, USA", "location": { "lat": 40.7123227, "lng": -74.0067737 }, "placeId": "ChIJkeCFmxhawokRSnmM-HD6jK4", "featureId": "0x89c25a189b85e091:0xae8cfa70f88c794a", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "sourceUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "timezone": "America/New_York", "timezoneAbbreviation": "EST", "utcOffset": "-05:00", "utcOffsetSeconds": -18000, "currentLocalTime": "2026-11-10T10:34:06-05:00", "currentUtcTime": "2026-11-10T15:34:06Z", "dayOfWeek": "Tuesday", "unixTimestamp": 1794324846, "isDaylightSavingTime": false, "daylightSavings": { "inEffect": false, "observed": true, "nextTransition": "2027-03-14T07:00:00Z", "standardUtcOffset": "-05:00", "standardUtcOffsetSeconds": -18000, "dstOffsetSeconds": 3600, "dstUtcOffsetSeconds": -14400, "startsAt": "2027-03-14T07:00:00Z", "endsAt": "2027-11-07T06:00:00Z" }, "distanceMeters": 84.1 } ] } } }, "400": { "description": "Invalid, missing or unknown input fields. Nothing ran.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "invalid_input", "errorDescription": "mode: required" } } } }, "422": { "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected failure. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "The request used up its 240 s budget. The results found so far are in partialItems.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "partialItems": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } } } } ] } } } } } }, "post": { "operationId": "lookupPost", "summary": "Run one lookup (JSON body)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "coordinates", "place", "placeId", "mixed" ], "description": "Coordinates resolves latitude/longitude pairs. Place looks up an address, landmark or business name. Place ID resolves a Google Place ID or Maps URL. Mixed processes every filled list in one run." }, "location": { "type": "object", "description": "One coordinate as {\"lat\": 40.7128, \"lng\": -74.006}. Decimal degrees, WGS84." }, "locations": { "type": "array", "items": { "type": "object" }, "maxItems": 10, "description": "A list of coordinates, each {\"lat\": 40.7128, \"lng\": -74.006}." }, "address": { "type": "string", "description": "One address, landmark, business name or postcode. Example: Eiffel Tower, Paris." }, "addresses": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "One address, landmark, business name or postcode per line." }, "placeId": { "type": "string", "description": "One Google Place ID (starts with ChIJ) or a full Google Maps place URL." }, "placeIds": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "One Google Place ID or Google Maps place URL per line." }, "language": { "type": "string", "enum": [ "en", "en-GB", "de", "fr", "es", "es-419", "it", "pt-BR", "pt-PT", "nl", "pl", "sv", "da", "no", "fi", "cs", "sk", "hu", "ro", "bg", "el", "tr", "ru", "uk", "ar", "he", "hi", "th", "vi", "id", "ms", "ja", "ko", "zh-CN", "zh-TW" ], "default": "en", "description": "Language Google Maps uses for returned place names, addresses and country names. It does not translate the query itself." }, "country": { "type": "string", "enum": [ "", "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ], "default": "", "description": "Optional ISO 3166-1 alpha-2 country code. The country name is added to place and address queries so an ambiguous search resolves in that country first. Leave empty for no bias. Coordinates are unaffected." } }, "additionalProperties": false }, "example": { "mode": "coordinates", "location": { "lat": 40.7128, "lng": -74.006 } } } } }, "responses": { "200": { "description": "The results as a JSON array (at most 30). They are also saved to the run's dataset and billed per result, like a normal run.", "headers": { "X-Item-Count": { "schema": { "type": "integer" }, "description": "Results returned." }, "X-Status-Message": { "schema": { "type": "string" }, "description": "The Actor's last status message, e.g. why nothing was found." } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "example": [ { "recordType": "timezone", "mode": "coordinates", "resolved": true, "language": "en", "scrapedAt": "2026-11-10T15:34:06.180049+00:00", "inputLocation": { "lat": 40.7128, "lng": -74.006 }, "placeName": "Chambers St", "formattedAddress": "Chambers St, New York, NY 10007, USA", "location": { "lat": 40.7123227, "lng": -74.0067737 }, "placeId": "ChIJkeCFmxhawokRSnmM-HD6jK4", "featureId": "0x89c25a189b85e091:0xae8cfa70f88c794a", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "sourceUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "timezone": "America/New_York", "timezoneAbbreviation": "EST", "utcOffset": "-05:00", "utcOffsetSeconds": -18000, "currentLocalTime": "2026-11-10T10:34:06-05:00", "currentUtcTime": "2026-11-10T15:34:06Z", "dayOfWeek": "Tuesday", "unixTimestamp": 1794324846, "isDaylightSavingTime": false, "daylightSavings": { "inEffect": false, "observed": true, "nextTransition": "2027-03-14T07:00:00Z", "standardUtcOffset": "-05:00", "standardUtcOffsetSeconds": -18000, "dstOffsetSeconds": 3600, "dstUtcOffsetSeconds": -14400, "startsAt": "2027-03-14T07:00:00Z", "endsAt": "2027-11-07T06:00:00Z" }, "distanceMeters": 84.1 } ] } } }, "400": { "description": "Invalid, missing or unknown input fields. Nothing ran.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "invalid_input", "errorDescription": "mode: required" } } } }, "422": { "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected failure. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "The request used up its 240 s budget. The results found so far are in partialItems.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "partialItems": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } } } } ] } } } } } } } }, "components": { "schemas": { "Item": { "type": "object", "description": "One result, the same record a normal run saves to its dataset.", "properties": { "recordType": { "type": "string" }, "mode": { "type": "string" }, "resolved": { "type": "boolean" }, "language": { "type": "string" }, "scrapedAt": { "type": "string" }, "inputLocation": { "type": "object" }, "placeName": { "type": "string" }, "formattedAddress": { "type": "string" }, "location": { "type": "object" }, "placeId": { "type": "string" }, "featureId": { "type": "string" }, "googleMapsUrl": { "type": "string" }, "sourceUrl": { "type": "string" }, "timezone": { "type": "string" }, "timezoneAbbreviation": { "type": "string" }, "utcOffset": { "type": "string" }, "utcOffsetSeconds": { "type": "integer" }, "currentLocalTime": { "type": "string" }, "currentUtcTime": { "type": "string" }, "dayOfWeek": { "type": "string" }, "unixTimestamp": { "type": "integer" }, "isDaylightSavingTime": { "type": "boolean" }, "daylightSavings": { "type": "object" }, "distanceMeters": { "type": "number" } }, "example": { "recordType": "timezone", "mode": "coordinates", "resolved": true, "language": "en", "scrapedAt": "2026-11-10T15:34:06.180049+00:00", "inputLocation": { "lat": 40.7128, "lng": -74.006 }, "placeName": "Chambers St", "formattedAddress": "Chambers St, New York, NY 10007, USA", "location": { "lat": 40.7123227, "lng": -74.0067737 }, "placeId": "ChIJkeCFmxhawokRSnmM-HD6jK4", "featureId": "0x89c25a189b85e091:0xae8cfa70f88c794a", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "sourceUrl": "https://www.google.com/maps/place/?q=place_id:ChIJkeCFmxhawokRSnmM-HD6jK4", "timezone": "America/New_York", "timezoneAbbreviation": "EST", "utcOffset": "-05:00", "utcOffsetSeconds": -18000, "currentLocalTime": "2026-11-10T10:34:06-05:00", "currentUtcTime": "2026-11-10T15:34:06Z", "dayOfWeek": "Tuesday", "unixTimestamp": 1794324846, "isDaylightSavingTime": false, "daylightSavings": { "inEffect": false, "observed": true, "nextTransition": "2027-03-14T07:00:00Z", "standardUtcOffset": "-05:00", "standardUtcOffsetSeconds": -18000, "dstOffsetSeconds": 3600, "dstUtcOffsetSeconds": -14400, "startsAt": "2027-03-14T07:00:00Z", "endsAt": "2027-11-07T06:00:00Z" }, "distanceMeters": 84.1 } }, "Error": { "type": "object", "required": [ "error", "errorDescription" ], "properties": { "error": { "type": "string", "enum": [ "invalid_input", "request_failed", "internal_error", "timeout", "busy", "not_found", "method_not_allowed", "payload_too_large" ] }, "errorDescription": { "type": "string" } } } }, "securitySchemes": { "apifyToken": { "type": "http", "scheme": "bearer", "description": "Your Apify API token (Apify Console, Settings, API and integrations)." } } }, "servers": [ { "url": "https://dataspryva--google-maps-timezone-and-local-time-lookup.apify.actor" } ], "security": [ { "apifyToken": [] } ] }