GooglePlaces Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
GMSFetchPlaceRequest
@interface GMSFetchPlaceRequest : NSObject
Request object to use with GMSPlacesClient to fetch a place.
-
Declaration
Objective-C
- (nonnull instancetype)
initWithPlaceID:(nonnull NSString *)placeID
placeProperties:(nonnull NSArray<NSString *> *)placeProperties
sessionToken:(nullable GMSAutocompleteSessionToken *)sessionToken;
Parameters
placeID
|
The ID of the place to be requested.
|
placeProperties
|
The properties of the place to be requested. Must not be empty. An empty
list will result in an error when trying to send the request. Read more about Place
Data Fields.
|
sessionToken
|
|
-
Default init is not available. Please use the designated initializer.
Declaration
Objective-C
- (nonnull instancetype)init;
-
Place ID of the place being requested.
Declaration
Swift
var placeID: String { get }
Objective-C
@property (nonatomic, copy, readonly) NSString *_Nonnull placeID;
-
Place properties to include in the GMSPlace response. Must not be empty. An empty list will
result in an error when trying to send the request.
Declaration
Swift
var placeProperties: [String] { get }
Objective-C
@property (nonatomic, copy, readonly) NSArray<NSString *> *_Nonnull placeProperties;
-
Session token to associate request to a billing session.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003e\u003ccode\u003eGMSFetchPlaceRequest\u003c/code\u003e objects are used with \u003ccode\u003eGMSPlacesClient\u003c/code\u003e to fetch details about a specific place using its ID.\u003c/p\u003e\n"],["\u003cp\u003eRequests must specify the \u003ccode\u003eplaceID\u003c/code\u003e and desired \u003ccode\u003eplaceProperties\u003c/code\u003e to retrieve data fields for the place.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003esessionToken\u003c/code\u003e can be included to associate the request with a billing session, particularly useful for autocomplete queries.\u003c/p\u003e\n"],["\u003cp\u003eThe default \u003ccode\u003einit\u003c/code\u003e method is unavailable; use \u003ccode\u003einitWithPlaceID:placeProperties:sessionToken:\u003c/code\u003e to create a request instance.\u003c/p\u003e\n"],["\u003cp\u003eThe requested \u003ccode\u003eplaceProperties\u003c/code\u003e array cannot be empty; otherwise, an error will occur when sending the request.\u003c/p\u003e\n"]]],[],null,["# GooglePlaces Framework Reference\n\nGMSFetchPlaceRequest\n====================\n\n @interface GMSFetchPlaceRequest : NSObject\n\nRequest object to use with [GMSPlacesClient](../Classes/GMSPlacesClient.html) to fetch a place.\n- `\n ``\n ``\n `\n\n ### [-initWithPlaceID:placeProperties:sessionToken:](#/c:objc(cs)GMSFetchPlaceRequest(im)initWithPlaceID:placeProperties:sessionToken:)\n\n `\n ` \n Request object to use with [GMSPlacesClient](../Classes/GMSPlacesClient.html) to fetch a place. \n\n #### Declaration\n\n Swift \n\n init(placeID: String, placeProperties: [String], sessionToken: ../Classes/GMSAutocompleteSessionToken.html?)\n\n Objective-C \n\n - (nonnull instancetype)\n initWithPlaceID:(nonnull NSString *)placeID\n placeProperties:(nonnull NSArray\u003cNSString *\u003e *)placeProperties\n sessionToken:(nullable ../Classes/GMSAutocompleteSessionToken.html *)sessionToken;\n\n #### Parameters\n\n |-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | ` `*placeID*` ` | The ID of the place to be requested. |\n | ` `*placeProperties*` ` | The properties of the place to be requested. Must not be empty. An empty list will result in an error when trying to send the request. Read more about [Place Data Fields](https://developers.google.com/maps/documentation/places/ios-sdk/place-data-fields). |\n | ` `*sessionToken*` ` | The [GMSAutocompleteSessionToken](../Classes/GMSAutocompleteSessionToken.html) to associate request to a billing session. |\n\n- `\n ``\n ``\n `\n\n ### [-init](#/c:objc(cs)GMSFetchPlaceRequest(im)init)\n\n `\n ` \n Unavailable \n Default init is not available. Please use the designated initializer. \n\n #### Declaration\n\n Objective-C \n\n - (nonnull instancetype)init;\n\n- `\n ``\n ``\n `\n\n ### [placeID](#/c:objc(cs)GMSFetchPlaceRequest(py)placeID)\n\n `\n ` \n Place ID of the place being requested. \n\n #### Declaration\n\n Swift \n\n var placeID: String { get }\n\n Objective-C \n\n @property (nonatomic, copy, readonly) NSString *_Nonnull placeID;\n\n- `\n ``\n ``\n `\n\n ### [placeProperties](#/c:objc(cs)GMSFetchPlaceRequest(py)placeProperties)\n\n `\n ` \n Place properties to include in the [GMSPlace](../Classes/GMSPlace.html) response. Must not be empty. An empty list will\n result in an error when trying to send the request. \n\n #### Declaration\n\n Swift \n\n var placeProperties: [String] { get }\n\n Objective-C \n\n @property (nonatomic, copy, readonly) NSArray\u003cNSString *\u003e *_Nonnull placeProperties;\n\n- `\n ``\n ``\n `\n\n ### [sessionToken](#/c:objc(cs)GMSFetchPlaceRequest(py)sessionToken)\n\n `\n ` \n Session token to associate request to a billing session. \n\n #### Declaration\n\n Swift \n\n @NSCopying var sessionToken: ../Classes/GMSAutocompleteSessionToken.html? { get }\n\n Objective-C \n\n @property (nonatomic, copy, readonly, nullable) ../Classes/GMSAutocompleteSessionToken.html *sessionToken;"]]
