PISO Maps API
API Documentation

Google Maps Place Results API

GET /api/maps/place — Get full details about a place

Retrieve comprehensive information about a place including description, reviews, menu, photos, popular times, and more.

Endpoint

GET /api/maps/place

Headers

NameValueRequired
x-api-keyYour API keyYes

Query Parameters

NameTypeRequiredDefaultDescription
data_idstringYesPlace identifier from Autocomplete or Search
latnumberNo10.801671Latitude for location context
lngnumberNo106.61744Longitude for location context

Example Request

curl "https://api.piso.dev/api/maps/place?data_id=0x31752bb396ca47f9:0x237d4c6fae045dd9&lat=10.801671&lng=106.61744" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "place_result": {
    "data_id": "0x31752bb396ca47f9:0x237d4c6fae045dd9",
    "place_id": "ChIJ-fGSpjOo1jERVN0ErG9MfSM",
    "title": "Highlands Coffee",
    "description": "Highlands Coffee is a Vietnamese coffee chain offering a variety of coffee drinks, smoothies, and snacks in a cozy atmosphere.",
    "type": "cafe",
    "rating": 4.2,
    "reviews": 1234,
    "pricing": {
      "min": 30000,
      "max": 65000
    },
    "contacts": {
      "phone": "02838277979",
      "website": "https://highlandscoffee.com.vn"
    },
    "location": {
      "latitude": 10.7765,
      "longitude": 106.7008,
      "timezone": "Asia/Ho_Chi_Minh",
      "country_code": "VN",
      "address": {
        "full": "135 Hai Bà Trưng, Bến Nghé, Quận 1, Hồ Chí Minh, Vietnam",
        "street": "135 Hai Bà Trưng",
        "ward": "Bến Nghé",
        "city": "Quận 1",
        "country": "Việt Nam"
      }
    },
    "open_state": {
      "is_open_now": true,
      "text": "Open"
    },
    "opening_hours": [
      {
        "day": "Monday",
        "hours": "07:00–22:00"
      }
    ],
    "features": {
      "accessibility": ["Wheelchair-accessible entrance"],
      "parking": ["Free parking lot"],
      "payments": ["Debit cards", "Credit cards"],
      "service_options": ["Dine-in", "Takeaway", "Delivery"],
      "other": []
    },
    "popular_times": [
      {
        "day": "Monday",
        "hours": [
          {
            "hour": 10,
            "occupancy_percent": 45,
            "status": "normal",
            "time_label": "10:00"
          }
        ]
      }
    ],
    "review_list": [
      {
        "review_id": "abc123",
        "author_name": "Nguyễn Văn A",
        "author_profile_pic": "https://lh3.googleusercontent.com/...",
        "rating": 5,
        "relative_date": "a month ago",
        "text": "Great coffee and nice atmosphere. Highly recommended!",
        "photos": [
          {
            "id": "photo1",
            "url": "https://lh3.googleusercontent.com/...",
            "width": 800,
            "height": 600
          }
        ]
      }
    ],
    "menu": [
      {
        "dish_name": "Cà phê sữa đá",
        "media": [
          {
            "id": "menu1",
            "url": "https://lh3.googleusercontent.com/...",
            "width": 400,
            "height": 400
          }
        ]
      }
    ],
    "photos": [
      {
        "category_id": "cat1",
        "category_label": "Interior",
        "media": [
          {
            "id": "photo2",
            "url": "https://lh3.googleusercontent.com/...",
            "width": 1200,
            "height": 900
          }
        ]
      }
    ],
    "google_maps_url": "https://www.google.com/maps/place/...",
    "global_plus_code": "7P28QQ8R+9G"
  }
}

Response Fields

FieldTypeDescription
place_resultobjectFull place detail object
place_result.data_idstringInternal place identifier
place_result.place_idstringGoogle Maps place ID
place_result.titlestringPlace name
place_result.descriptionstringPlace description
place_result.typestringCategory (e.g. cafe, restaurant)
place_result.ratingnumberAverage rating (1.0–5.0)
place_result.reviewsintegerTotal review count
place_result.pricingobjectPrice range { min, max }
place_result.pricing_rangesarrayDetailed pricing tiers
place_result.contactsobject{ phone, website }
place_result.locationobjectLocation data (lat, lng, address, timezone, country_code)
place_result.open_stateobjectCurrent status { is_open_now, text }
place_result.opening_hoursarrayWeekly hours [{ day, hours }]
place_result.featuresobjectAccessibility, parking, payments, service_options
place_result.popular_timesarrayBusyness per hour by day
place_result.review_listarrayUser reviews with author, rating, text, photos
place_result.menuarrayMenu items with dish name and photos
place_result.photosarrayCategorized photo gallery
place_result.google_maps_urlstringLink to the place on Google Maps
place_result.global_plus_codestringPlus code for the location

Errors

StatusMeaning
401Missing or invalid API key
422Invalid or missing query parameter
429Rate limit exceeded
500Internal server error

On this page