> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# googleMapsPlace

`POST /v1/google-maps/place`

**Tags:** `Google maps`

Get a Google Maps place

**Endpoint:** `https://api.fiber.ai/v1/google-maps/place`

## Description

Get detailed information about a Google Maps place, including hours, contact details, ratings, and attributes. Search for places via `POST /v1/google-maps/search`.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: 2 credits per place lookup ⓘ

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "placeId": {
      "type": "string",
      "minLength": 1,
      "description": "Google Maps place ID (e.g. 'ChIJN1t_tDeuEmsRUsoyG83frY4'). Obtain it from the `placeId` of a result returned by the Google Maps search endpoint (`POST /v1/google-maps/search`)."
    }
  },
  "required": [
    "apiKey",
    "placeId"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "place": {
          "type": "object",
          "properties": {
            "placeId": {
              "type": "string",
              "description": "Google Maps place ID. Use with POST /v1/google-maps/place and POST /v1/google-maps/reviews."
            },
            "name": {
              "type": "string",
              "description": "Place display name."
            },
            "url": {
              "type": "string",
              "description": "Google Maps page for this place."
            },
            "rating": {
              "type": [
                "number",
                "null"
              ],
              "minimum": 0,
              "maximum": 5,
              "description": "Average star rating from 0 to 5."
            },
            "reviewCount": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Total review count."
            },
            "phoneNumber": {
              "type": [
                "string",
                "null"
              ],
              "description": "Contact phone number in E.164 format when the country can be determined, otherwise as listed on Google Maps."
            },
            "websiteUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "Website URL for this place."
            },
            "address": {
              "type": [
                "string",
                "null"
              ],
              "description": "Street address of the place."
            },
            "categories": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Categories this place belongs to (e.g. 'Coffee shop', 'Park', 'Subway station')."
            },
            "openingHours": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "dayOfWeek": {
                    "type": "string",
                    "enum": [
                      "monday",
                      "tuesday",
                      "wednesday",
                      "thursday",
                      "friday",
                      "saturday",
                      "sunday"
                    ],
                    "description": "Day of the week."
                  },
                  "hours": {
                    "type": "string",
                    "description": "Opening hours for the day, as displayed on the Google Maps page for the place (e.g. '12–2:30 PM, 5–9 PM')."
                  }
                },
                "required": [
                  "dayOfWeek",
                  "hours"
                ]
              },
              "description": "Opening hours by day of the week, when available."
            },
            "coordinates": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "latitude": {
                  "type": "number",
                  "minimum": -90,
                  "maximum": 90,
                  "description": "The latitude of the point."
                },
                "longitude": {
                  "type": "number",
                  "minimum": -180,
                  "maximum": 180,
                  "description": "The longitude of the point."
                }
              },
              "required": [
                "latitude",
                "longitude"
              ],
              "description": "Geographic coordinates of the place."
            },
            "thumbnailUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "Thumbnail image URL for this place."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Short description of the place."
            },
            "ratingBreakdown": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "stars": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5,
                    "description": "Star rating this bucket represents, from 1 to 5."
                  },
                  "count": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Number of reviews with this star rating."
                  }
                },
                "required": [
                  "stars",
                  "count"
                ]
              },
              "description": "Count of reviews per star rating, when available."
            },
            "attributes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "category": {
                    "type": "string",
                    "description": "Attribute group name (e.g. 'Service options', 'Highlights', 'Accessibility')."
                  },
                  "values": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Attribute values in this group (e.g. 'Dine-in', 'Delivery')."
                  }
                },
                "required": [
                  "category",
                  "values"
                ]
              },
              "description": "Grouped attributes such as service options, highlights, offerings, and accessibility."
            },
            "reviews": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "authorName": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Reviewer's display name."
                  },
                  "authorIsLocalGuide": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "True when the reviewer is a Google Local Guide."
                  },
                  "rating": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 1,
                    "maximum": 5,
                    "description": "Star rating given by the reviewer, from 1 to 5."
                  },
                  "publishedAt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Review publication time in ISO 8601 format."
                  },
                  "text": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Review text."
                  },
                  "likeCount": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "Number of likes the review received."
                  },
                  "photoUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Photo URLs attached to the review."
                  },
                  "reviewUrl": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Public URL for this review."
                  }
                },
                "required": [
                  "photoUrls"
                ]
              },
              "description": "A sample of recent reviews included with the place. Use POST /v1/google-maps/reviews for the full paginated list."
            }
          },
          "required": [
            "placeId",
            "name",
            "url",
            "categories",
            "openingHours",
            "ratingBreakdown",
            "attributes",
            "reviews"
          ],
          "description": "Detailed information about the Google Maps place."
        }
      },
      "required": [
        "place"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)