{"uid":"cap_v-ak1jfpummUKVhMjiTJi","slug":"agents-openwebninja-com-reverse-geocoding-via-google-maps-openweb-ninja-95e51148","name":"Reverse Geocoding via Google Maps (OpenWeb Ninja)","description":"Get the details of a place or address in a specific geographic location by latitude and longitude (reverse geocoding).  \n  This endpoint implements the \"What's here?\" functionality available on Google Maps (right click on the map).","url":"https://agents.openwebninja.com/local-business-data/reverse-geocoding?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"string","default":40.6958453,"example":"40.6958453","description":"Latitude of the geographic coordinates to search near by."},"lng":{"type":"string","default":-73.9799119,"example":"-73.9799119","description":"Longitude of the geographic coordinates to search near by."},"fields":{"type":"string","description":"A comma separated list of business fields to include in the response (field projection).  \n  By default all fields are returned."},"region":{"type":"string","default":"us","description":"Query Google Maps from a particular region or country.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."},"language":{"type":"string","default":"en","description":"Set the language of the results. For a list of supported language codes see *https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2*."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["business_id","google_id","name","business_status"],"properties":{"cid":{"type":"string","nullable":true,"description":"Google CID (Customer ID) of the business."},"tld":{"type":"string","nullable":true,"description":"Top-level domain of the business website."},"city":{"type":"string","nullable":true,"description":"City of the business location."},"name":{"type":"string","description":"Display name of the business."},"type":{"type":"string","nullable":true,"description":"Primary business category as labelled by Google Maps."},"about":{"type":"object","nullable":true,"properties":{"details":{"type":"object","nullable":true,"description":"Map of attribute groups (e.g. Amenities, Crowd, Service options) to attribute name -> boolean.","additionalProperties":{"type":"object","additionalProperties":{"type":"boolean"}}},"summary":{"type":"string","nullable":true,"description":"Free-text description of the business."}},"description":"Free-form summary and a structured details map of business attributes."},"state":{"type":"string","nullable":true,"description":"State / region of the business location."},"rating":{"type":"number","nullable":true,"description":"Average review rating (1-5) on Google Maps."},"address":{"type":"string","nullable":true,"description":"Street address line of the business."},"country":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the business location."},"website":{"type":"string","nullable":true,"description":"Business website URL."},"zipcode":{"type":"string","nullable":true,"description":"ZIP / postal code of the business location."},"district":{"type":"string","nullable":true,"description":"District or neighbourhood of the business location."},"latitude":{"type":"number","description":"Latitude of the business location."},"owner_id":{"type":"string","nullable":true,"description":"ID of the Google Maps contributor account that owns this listing."},"place_id":{"type":"string","description":"Google Maps Place ID."},"subtypes":{"type":"array","items":{"type":"string"},"nullable":true,"description":"List of additional business categories."},"timezone":{"type":"string","nullable":true,"description":"IANA timezone of the business location."},"verified":{"type":"boolean","description":"Whether the business is verified by Google."},"directory":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"List of businesses located in the same building / directory (e.g. mall, plaza). Conditional."},"google_id":{"type":"string","description":"Google's internal hexadecimal ID of the business."},"longitude":{"type":"number","description":"Longitude of the business location."},"menu_link":{"type":"string","nullable":true,"description":"URL of the business menu (when published)."},"google_mid":{"type":"string","nullable":true,"description":"Google Knowledge Graph machine ID."},"located_in":{"type":"object","nullable":true,"properties":{"name":{"type":"string","description":"Name of the parent place."},"google_id":{"type":"string","description":"Google ID of the parent place."}},"description":"Parent place this business is located in (e.g. mall) when applicable."},"order_link":{"type":"string","nullable":true,"description":"URL to place an order (when published)."},"owner_link":{"type":"string","nullable":true,"description":"Link to the owner profile on Google Maps."},"owner_name":{"type":"string","nullable":true,"description":"Display name of the owner profile."},"place_link":{"type":"string","description":"Google Maps URL for the business."},"posts_link":{"type":"string","nullable":true,"description":"URL to the full list of owner posts on Google Maps."},"share_link":{"type":"string","nullable":true,"description":"Shortened Google Maps share URL for the business. Returned when extract_share_link=true."},"business_id":{"type":"string","description":"Unique Google identifier of the business. Same value as google_id."},"hotel_stars":{"type":"integer","nullable":true,"description":"Hotel-only: star rating (1-5). Present only for hotels."},"photo_count":{"type":"integer","nullable":true,"description":"Total number of photos available for the business."},"price_level":{"type":"string","nullable":true,"description":"Price level as shown on Google Maps (e.g. '$', '$$')."},"booking_link":{"type":"string","nullable":true,"description":"URL to book a service or appointment."},"full_address":{"type":"string","description":"Full formatted address including business name."},"opening_date":{"type":"string","nullable":true,"description":"Date the business opened (when published by Google)."},"phone_number":{"type":"string","nullable":true,"description":"Business phone number in E.164 format when available."},"posts_sample":{"type":"array","items":{"type":"object","properties":{"post_id":{"type":"string","description":"Unique Google identifier of the owner post."},"post_link":{"type":"string","nullable":true,"description":"Direct URL to the post on Google."},"post_text":{"type":"string","nullable":true,"description":"Text content of the post."},"post_links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Target URL of the link."},"caption":{"type":"string","nullable":true,"description":"Caption of the link as shown on the post."}}},"nullable":true,"description":"Outbound links attached to the post."},"post_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the post."},"post_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching post_datetime_utc."},"post_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the post was published."}}},"nullable":true,"description":"Sample of the most recent owner posts. Present in /business-details and /business-details-plus."},"review_count":{"type":"integer","nullable":true,"description":"Total number of Google Maps reviews on the business."},"reviews_link":{"type":"string","nullable":true,"description":"URL to view reviews on Google Maps."},"photos_sample":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Media type. Values: photo, video, street_view."},"latitude":{"type":"number","nullable":true,"description":"Latitude where the photo was taken (when known)."},"photo_id":{"type":"string","description":"Google Maps photo ID."},"longitude":{"type":"number","nullable":true,"description":"Longitude where the photo was taken (when known)."},"photo_url":{"type":"string","description":"URL of the photo (lower-resolution)."},"photo_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching photo_datetime_utc."},"photo_url_large":{"type":"string","nullable":true,"description":"URL of the photo at a larger resolution."},"photo_datetime_utc":{"type":"string","nullable":true,"description":"Original publication datetime of the photo in ISO 8601 UTC."},"video_thumbnail_url":{"type":"string","nullable":true,"description":"Thumbnail URL when the media is a video; null for still photos."}}},"nullable":true,"description":"Up to ~10 representative photos for the business."},"subtype_gcids":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Internal Google category IDs corresponding to the primary type and subtypes."},"working_hours":{"type":"object","nullable":true,"description":"Working hours map keyed by day of the week. Each value is an array of time-range strings; empty object when not published.","additionalProperties":{"type":"array","items":{"type":"string"}}},"opening_status":{"type":"string","nullable":true,"description":"Current opening status string as shown on Google Maps (e.g. 'Open', 'Closed', 'Open 24 hours')."},"reviews_sample":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","description":"Star rating given in the review (1-5)."},"author_id":{"type":"string","nullable":true,"description":"Google Maps contributor ID of the review author."},"review_id":{"type":"string","description":"Unique Google identifier of the review."},"like_count":{"type":"integer","nullable":true,"description":"Number of likes the review received."},"author_link":{"type":"string","nullable":true,"description":"URL to the author's Google Maps profile."},"author_name":{"type":"string","nullable":true,"description":"Display name of the review author."},"review_form":{"type":"object","nullable":true,"description":"Structured questions the author answered (e.g. 'What kind of trip was it?').","additionalProperties":{"type":"string"}},"review_link":{"type":"string","nullable":true,"description":"Direct Google Maps URL to the review."},"review_text":{"type":"string","nullable":true,"description":"Full text content of the review."},"review_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the review."},"review_source":{"type":"string","nullable":true,"description":"Platform the review originates from (e.g. 'Google', 'Tripadvisor')."},"review_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the review text."},"service_quality":{"type":"string","nullable":true,"description":"Optional service-quality tag the author selected."},"author_photo_url":{"type":"string","nullable":true,"description":"URL of the author's profile photo."},"review_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching review_datetime_utc."},"author_review_count":{"type":"integer","nullable":true,"description":"Number of reviews this author has posted."},"author_reviews_link":{"type":"string","nullable":true,"description":"URL to all reviews by this author."},"owner_response_text":{"type":"string","nullable":true,"description":"Text of the business owner's response."},"review_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the review was posted."},"hotel_rating_breakdown":{"type":"object","nullable":true,"description":"Hotel-only: per-aspect ratings (Rooms, Service, Location, etc.).","additionalProperties":{"type":"integer"}},"owner_response_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the owner response."},"author_local_guide_level":{"type":"integer","nullable":true,"description":"Google Local Guide level (1-10) of the author."},"owner_response_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching owner_response_datetime_utc."},"owner_response_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the business owner responded."}}},"nullable":true,"description":"Sample of recent reviews. Present in /business-details and /business-details-plus."},"street_address":{"type":"string","nullable":true,"description":"Street name and number portion of the address."},"business_status":{"type":"string","description":"Operational status. Values: OPEN, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY."},"hotel_amenities":{"type":"object","nullable":true,"description":"Hotel-only: map of amenity name to availability (true/false). Present only for hotels.","additionalProperties":{"type":"boolean"}},"global_plus_code":{"type":"string","nullable":true,"description":"Global Open Location Code (Plus Code) for the business location."},"business_services":{"type":"object","nullable":true,"description":"Map of service category -> list of services offered (when published by the owner).","additionalProperties":{"type":"array","items":{"type":"string"}}},"reservations_link":{"type":"string","nullable":true,"description":"URL to make a reservation."},"compound_plus_code":{"type":"string","nullable":true,"description":"Compound (short) Plus Code with a nearby locality."},"reviews_per_rating":{"type":"object","nullable":true,"properties":{"1":{"type":"integer","description":"Number of 1-star reviews."},"2":{"type":"integer","description":"Number of 2-star reviews."},"3":{"type":"integer","description":"Number of 3-star reviews."},"4":{"type":"integer","description":"Number of 4-star reviews."},"5":{"type":"integer","description":"Number of 5-star reviews."}},"description":"Counts of reviews per integer rating from 1 to 5."},"emails_and_contacts":{"type":"object","nullable":true,"properties":{"yelp":{"type":"string","nullable":true,"description":"Yelp listing URL."},"emails":{"type":"array","items":{"type":"string"},"description":"Email addresses found on the business website."},"github":{"type":"string","nullable":true,"description":"GitHub profile URL."},"tiktok":{"type":"string","nullable":true,"description":"TikTok profile URL."},"twitter":{"type":"string","nullable":true,"description":"Twitter/X profile URL."},"youtube":{"type":"string","nullable":true,"description":"YouTube channel URL."},"facebook":{"type":"string","nullable":true,"description":"Facebook profile URL."},"linkedin":{"type":"string","nullable":true,"description":"LinkedIn profile URL."},"snapchat":{"type":"string","nullable":true,"description":"Snapchat profile URL."},"instagram":{"type":"string","nullable":true,"description":"Instagram profile URL."},"pinterest":{"type":"string","nullable":true,"description":"Pinterest profile URL."},"phone_numbers":{"type":"array","items":{"type":"string"},"description":"Phone numbers found on the business website."}},"description":"Emails and social-network profiles extracted from the business website. Populated when extract_emails_and_contacts=true (the default for /business-details)."},"hotel_review_summary":{"type":"object","nullable":true,"description":"Hotel-only: AI-generated review summary. Present only for hotels.","additionalProperties":true},"hotel_booking_options":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: array of booking options (provider, price, link). Present only for hotels with live rates."},"hotel_location_rating":{"type":"object","nullable":true,"description":"Hotel-only: location rating breakdown when the business is a hotel.","additionalProperties":true},"hotel_price_for_dates":{"type":"string","nullable":true,"description":"Hotel-only: nightly price string when Google has live rates."},"requested_business_id":{"type":"string","description":"The exact business_id from the request, echoed back. Useful when batching multiple IDs."},"hotel_results_from_web":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: additional web-sourced results / reviews shown alongside the Google listing."},"keywords_mentioned_in_reviews":{"type":"array","items":{"type":"object","required":["keyword","review_count"],"properties":{"keyword":{"type":"string","description":"The keyword extracted from reviews."},"review_count":{"type":"integer","description":"Number of reviews mentioning this keyword."}}},"nullable":true,"description":"Keywords most frequently mentioned in reviews, with counts. Returned by /business-details-plus only (AI-enriched, ?extended_details=true)."}}},"description":"List of businesses returned."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude as received."},"lng":{"type":"number","description":"Longitude as received."},"region":{"type":"string","description":"Region code used for the request."},"language":{"type":"string","description":"Language code used for the response."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_BywSxmSKEHIxkxhUS8AOK","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns place and address details for a given latitude/longitude coordinate pair by performing reverse geocoding against Google Maps data.","exampleAgentPrompt":"What place or address is at latitude 40.6958453, longitude -73.9799119? Give me the full business details including name, address, and category in English for the US region.","exampleUseCases":[{"title":"Identify unknown GPS pin on map","prompt":"I have GPS coordinates 37.7749, -122.4194 — can you tell me exactly what place or address is at that location and what type of business it is?"},{"title":"Enrich delivery location data","prompt":"We have a delivery drop-off recorded at lat 51.5074, lng -0.1278 in the UK — can you look up what's actually there and give me the full address details?"},{"title":"Verify field sales visit location","prompt":"Our sales rep checked in at coordinates 34.0522, -118.2437 — what business or address is at that location according to Google Maps, including the business name and category?"}],"resultDescription":"An array of place/business objects matching the coordinates, each containing: display name, full address (street, city, state, ZIP, country, district), business type/category, Google CID, average rating, website URL, latitude/longitude, owner info, and structured attribute details (amenities, service options, etc.). Also includes request metadata (status, request_id, parameters).","failureModes":["Invalid or out-of-range lat/lng values return an error or empty data array","Coordinates in the middle of an ocean or unpopulated area may return no results","Unsupported region or language codes may default to base behavior or return an error","Rate limiting or quota exhaustion returns a 402 or 429 status","Truncated field projection if 'fields' parameter contains invalid field names"],"whenToPreferThis":"Choose this endpoint when you have geographic coordinates (lat/lng) and need to identify the place, business, or address at that location — especially when you want rich Google Maps business metadata (ratings, categories, website, attributes) beyond a simple address string. Prefer this over forward-geocoding endpoints when you are starting from coordinates rather than a name or address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:57.845Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-reverse-geocoding-via-google-maps-openweb-ninja-95e51148"}