Search

Request

Search returns addresses or Points of Interest located around a specified coordinate location.

GET https://apis.location.studio/geo/v2/search/json

Required Parameters

api_key

String

Your Location Studio API Key

search_center

String

search_center is used for a proximity based match to the address. The search will lookup addresses within 100 miles of the search center to find the specified address using a partial match. If the address is further than this distance, greater detail must be specified in the address in order for the search to find the location.

query

String

Street address of the location to return the lat/long for. This can be a full or partial address.

type

String

Must be set to 'address-only' to perform a forward gecode operation.

Response

Description

Search results are returned in a place array unless matches are not found in which case HTTP status 204 is returned. Please see the listing of Status Codes for additional details. If an error does not occur and there are matches, the response consists of one or more place elements.

Each result within the place array has a name property and may contain the following fields:

  • name - Name of the POI.

  • distance - distance from the search_center in meters. Alternatively, the distance will be calculated from the user_position if it is provided.

  • location - contains the following information:

    • city city - name of the returned address.

    • coordinate - contains the latitude and longitude value.

    • country - The country name in long form. For example, "United States".

    • country_code - The ISO 3166-1 three character country code. For example, "USA".

    • formatted_address - The returned address formatted as a single line of text. For example, "25381 Alicia Pky, Laguna Hills, CA 92653, USA".

    • house_number - The house number in the street. For example, "25381" in "25381 Alicia Pky".

    • postal - The postal code.

    • state - state name of the returned address.

    • street - street name of the returned address.

    • type - type of the returned address. The following values are supported:

      • airport

      • street

      • intersection

  • accuracy - Accuracy of the match. Supported only for address match ("type=address-only"). Possible values are 1 to 10 where 10 is the highest.

  • phones - List of phone numbers associated with a place. The properties of phone are:

    • type - Type of phone number. Can be any one of 'primary', 'secondary', 'national', 'mobile' or 'fax'.

    • area

    • country

    • ext - indicates the extension for the telephone number.

    • number

  • categories - is an array indicating the categories of the place. For example, "Grocery Stores".

    • code - category code

    • name - category name

    • parent_category

      • code - category code

      • name - category name

  • brand - array indicating the brands associated with the place.

    • id - brand id

    • name - brand name

  • fuel_price - List of fuel price details for the place.

    • value - fuel price

    • units - Fuel units. Supported values are “G” for gallon and “L” for liter.

    • type - Type of fuel. Supported values are “r” for regular, “m” for mid-grade, “p” for premium, “d” for diesel, “e” for ethanol-85.

    • currency - Specifies currency units of the price. ISO 4217 Code (http://en.wikipedia.org/wiki/ISO_4217). Example: “USD” for US dollars.

  • enhanced_contents

Additional POI content, including advertisement specific information, etc.

  • payment_method - A comma separated list of payment methods accepted.

  • cuisines - Text description of the cuisines of the restaurant.

  • description - Description of the Business.

  • features - Text description of the features of the business.

  • special_features - Restaurant special features, including amenities and specialities.

  • parking - Text describing parking options.

  • price - Text describing the range of prices for goods / services the business provides.

  • reservations - Text describing the reservations options provided by the business.

  • wifi - Text value indicating whether WiFi is Free or Paid, if available at all.

  • dress_code - Text describing attire restrictions.

  • good_for - Restaurants only: "business", "romance", etc.

  • smoking - Text describing smoking restrictions.

  • shuttle_service - Text describing shuttle service provided by the business.

  • tips - Text describing about tips for the business. Eg “arrive 30 mins early or reserve 2 hours ahead”.

  • hours_of_operation_text - Text describing the hours the business is open.

  • business_url - URL of the Business website.

  • thumbnail_photo_url - URL of the business thumbnail photo to be displayed in smaller views.

  • photo_url - URL of the business large photo.

  • photo_url_1 - URL of the business additional photo.

  • photo_url_2 - URL of the business additional photo.

  • photo_url_3 - URL of the business additional photo.

  • photo_url_4 - URL of the business additional photo.

  • hours_of_operation_structured

    • day_of_the_week - 0 (sun), 1(mon) to 6 (sat).

    • hours - contains list of business hours for the given day_of_the_week. If a business has multiple sessions (eg 6 AM to 9 AM, 11AM to 2 PM, 6PM to 9 PM), there will be multiple start-time and end-time for the day.

      • start_time Business - start time for a session. Represented in number of seconds since start of the day. Eg 7 AM will be 25200 (7 * 6 * 60).

      • end_time Business - end time for a session. Represented in number of seconds since start of the day. Eg 9 AM will be 32400 (9 * 6 * 60).

  • tripadvisor_contents - Contents from TripAdvisor that require UI attribution. TripAdvisor icon, average ratings, review count must be displayed as per TripAdvisor specifications. User should have an option to go to the TripAdvisor detail page. TripAdvisor Display Requirements.

    • iterator_status - Internal state of the iterator to be used for next and previous page requests.

    • exhausted - Indicates if more results are available for potential next page request. Supported values are "y" (yes) or "n" (no).

{
 "iterator_status" : "T2pFd0xFTTdNVEE3TVRBd0xqQT0K",
 "exhausted" : "n",
 "places" : [ {
   "name" : "Pacific Park Market",
   "distance" : 359.215,
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.55922,
       "longitude" : -117.72512
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27792 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "27792",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Liquor Stores",
     "code" : "AKO",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "8310330",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Quick Mart",
   "distance" : 1294.2313,
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57052,
       "longitude" : -117.72935
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "22952 Pacific Park Dr, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "22952",
     "state" : "CA",
     "street" : "Pacific Park Dr",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "7163600",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Mobil",
   "distance" : 1381.3029,
   "enhanced_contents" : {
     "business_url" : "http://mobil.com",
     "payment_method" : "American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56427,
       "longitude" : -117.71555
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27430 Alicia Pkwy, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27430",
     "state" : "CA",
     "street" : "Alicia Pkwy",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Car Wash",
     "code" : "ACJ",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 3.349,
     "units" : "G",
     "type" : "d",
     "currency" : "USD"
   }, {
     "value" : 2.989,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 3.099,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.199,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4251187",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Ralphs",
   "distance" : 1442.9886,
   "enhanced_contents" : {
     "business_url" : "http://ralphs.com",
     "hours_of_operation_text" : "Daily, 6am - 1am",
     "parking" : "Free lot, On-street: free",
     "payment_method" : "Mastercard,Visa",
     "thumbnail_photo_url" : "http://o5.aolcdn.com/dims-shared/dims3/PATCH/resize/600x450/http://hss-prod.hss.aol.com/hss/storage/patch/cbde11f5be18136c849a271e1bcb1ef0",
     "tips" : "You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit."
   },
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57149,
       "longitude" : -117.72528
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "26901 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "26901",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3623727",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Vons",
   "distance" : 1495.546,
   "enhanced_contents" : {
     "business_url" : "http://local.vons.com/ca/laguna-niguel-2508.html",
     "hours_of_operation_text" : "Daily 5am-1am",
     "payment_method" : "Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56607,
       "longitude" : -117.71534
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27320 Alicia Pkwy, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27320",
     "state" : "CA",
     "street" : "Alicia Pkwy",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Liquor Stores",
     "code" : "AKO",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Florists",
     "code" : "AKL",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Bakeries",
     "code" : "AEOG",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Restaurants",
     "code" : "AE",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Sandwiches",
     "code" : "AEYM",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4489244",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "76",
   "distance" : 1594.5978,
   "enhanced_contents" : {
     "business_url" : "http://76.com",
     "payment_method" : "American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57263,
       "longitude" : -117.72408
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "26871 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "26871",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Car Wash",
     "code" : "ACJ",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.979,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 3.079,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.179,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4251559",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Whole Foods Market",
   "distance" : 1599.0155,
   "enhanced_contents" : {
     "business_url" : "http://wholefoodsmarket.com",
     "hours_of_operation_structured" : [ {
       "day_of_the_week" : "0",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "1",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "2",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "3",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "4",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "5",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "6",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     } ],
     "hours_of_operation_text" : "Daily 7am-10pm"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.55545,
       "longitude" : -117.71224
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "23932 Aliso Creek Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "23932",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "9005830",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Ralphs",
   "distance" : 1762.652,
   "enhanced_contents" : {
     "business_url" : "http://ralphs.com",
     "features" : "Greeting cards|Flowers|Household essentials|Food and drink|Ice|Beer|Toys|Newspapers/magazines|Tobacco products",
     "hours_of_operation_text" : "Daily, 5 a.m. - 1 a.m",
     "parking" : "Free lot",
     "payment_method" : "Mastercard,Visa",
     "thumbnail_photo_url" : "http://o4.aolcdn.com/dims-shared/dims3/PATCH/resize/600x450/http://hss-prod.hss.aol.com/hss/storage/patch/cc0b52559c5fe46b0bad29f90eaa030d",
     "tips" : "You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit."
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.55766,
       "longitude" : -117.71003
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27871 La Paz Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27871",
     "state" : "CA",
     "street" : "La Paz Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3625921",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Costco Pharmacy",
   "distance" : 1873.285,
   "enhanced_contents" : {
     "business_url" : "http://costco.com",
     "hours_of_operation_text" : "Mon - Fri, 10am - 8:30pm; Sat, 9:30am - 6pm; Sun, 10am - 6pm; Pharmacy, Mon - Fri, 10am - 7pm; Sat, 9:30am - 6pm; Sun, closed",
     "payment_method" : "Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56817,
       "longitude" : -117.71212
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27220 Heather Ridge Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27220",
     "state" : "CA",
     "street" : "Heather Ridge Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Wholesale Clubs",
     "code" : "AKX",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Department Stores",
     "code" : "AKC",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Office Supplies",
     "code" : "AKV",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Houseware Stores",
     "code" : "AKU",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Furniture Stores",
     "code" : "AKT",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Clothing Stores",
     "code" : "AKI",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Shopping/Retail",
     "code" : "AK",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Retail Shops",
     "code" : "AKF",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.699,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 2.899,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3898702",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Arco",
   "distance" : 1984.6416,
   "enhanced_contents" : {
     "business_url" : "http://arco.com",
     "hours_of_operation_text" : "Daily 24 Hours",
     "payment_method" : "cash,checks,Debit Card,American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56402,
       "longitude" : -117.70848
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27491 La Paz Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27491",
     "state" : "CA",
     "street" : "La Paz Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.839,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 2.939,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.039,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "8310543",
     "country" : "1",
     "area" : "949"
   } ]
 } ]
}

Search

Request

Search returns addresses or Points of Interest located around a specified coordinate location.

GET https://apis.location.studio/geo/v2/search/json

Required Parameters

api_key

String

Your Location Studio API Key

search_center

String

search_center is used for a proximity based match to the address. The search will lookup addresses within 100 miles of the search center to find the specified address using a partial match. If the address is further than this distance, greater detail must be specified in the address in order for the search to find the location.

query

String

Street address of the location to return the lat/long for. This can be a full or partial address.

type

String

Must be set to 'address-only' to perform a forward gecode operation.

Response

Description

Search results are returned in a place array unless matches are not found in which case HTTP status 204 is returned. Please see the listing of Status Codes for additional details. If an error does not occur and there are matches, the response consists of one or more place elements.

Each result within the place array has a name property and may contain the following fields:

  • name - Name of the POI.

  • distance - distance from the search_center in meters. Alternatively, the distance will be calculated from the user_position if it is provided.

  • location - contains the following information:

    • city city - name of the returned address.

    • coordinate - contains the latitude and longitude value.

    • country - The country name in long form. For example, "United States".

    • country_code - The ISO 3166-1 three character country code. For example, "USA".

    • formatted_address - The returned address formatted as a single line of text. For example, "25381 Alicia Pky, Laguna Hills, CA 92653, USA".

    • house_number - The house number in the street. For example, "25381" in "25381 Alicia Pky".

    • postal - The postal code.

    • state - state name of the returned address.

    • street - street name of the returned address.

    • type - type of the returned address. The following values are supported:

      • airport

      • street

      • intersection

  • accuracy - Accuracy of the match. Supported only for address match ("type=address-only"). Possible values are 1 to 10 where 10 is the highest.

  • phones - List of phone numbers associated with a place. The properties of phone are:

    • type - Type of phone number. Can be any one of 'primary', 'secondary', 'national', 'mobile' or 'fax'.

    • area

    • country

    • ext - indicates the extension for the telephone number.

    • number

  • categories - is an array indicating the categories of the place. For example, "Grocery Stores".

    • code - category code

    • name - category name

    • parent_category

      • code - category code

      • name - category name

  • brand - array indicating the brands associated with the place.

    • id - brand id

    • name - brand name

  • fuel_price - List of fuel price details for the place.

    • value - fuel price

    • units - Fuel units. Supported values are “G” for gallon and “L” for liter.

    • type - Type of fuel. Supported values are “r” for regular, “m” for mid-grade, “p” for premium, “d” for diesel, “e” for ethanol-85.

    • currency - Specifies currency units of the price. ISO 4217 Code (http://en.wikipedia.org/wiki/ISO_4217). Example: “USD” for US dollars.

  • enhanced_contents

Additional POI content, including advertisement specific information, etc.

  • payment_method - A comma separated list of payment methods accepted.

  • cuisines - Text description of the cuisines of the restaurant.

  • description - Description of the Business.

  • features - Text description of the features of the business.

  • special_features - Restaurant special features, including amenities and specialities.

  • parking - Text describing parking options.

  • price - Text describing the range of prices for goods / services the business provides.

  • reservations - Text describing the reservations options provided by the business.

  • wifi - Text value indicating whether WiFi is Free or Paid, if available at all.

  • dress_code - Text describing attire restrictions.

  • good_for - Restaurants only: "business", "romance", etc.

  • smoking - Text describing smoking restrictions.

  • shuttle_service - Text describing shuttle service provided by the business.

  • tips - Text describing about tips for the business. Eg “arrive 30 mins early or reserve 2 hours ahead”.

  • hours_of_operation_text - Text describing the hours the business is open.

  • business_url - URL of the Business website.

  • thumbnail_photo_url - URL of the business thumbnail photo to be displayed in smaller views.

  • photo_url - URL of the business large photo.

  • photo_url_1 - URL of the business additional photo.

  • photo_url_2 - URL of the business additional photo.

  • photo_url_3 - URL of the business additional photo.

  • photo_url_4 - URL of the business additional photo.

  • hours_of_operation_structured

    • day_of_the_week - 0 (sun), 1(mon) to 6 (sat).

    • hours - contains list of business hours for the given day_of_the_week. If a business has multiple sessions (eg 6 AM to 9 AM, 11AM to 2 PM, 6PM to 9 PM), there will be multiple start-time and end-time for the day.

      • start_time Business - start time for a session. Represented in number of seconds since start of the day. Eg 7 AM will be 25200 (7 * 6 * 60).

      • end_time Business - end time for a session. Represented in number of seconds since start of the day. Eg 9 AM will be 32400 (9 * 6 * 60).

  • tripadvisor_contents - Contents from TripAdvisor that require UI attribution. TripAdvisor icon, average ratings, review count must be displayed as per TripAdvisor specifications. User should have an option to go to the TripAdvisor detail page. TripAdvisor Display Requirements.

    • iterator_status - Internal state of the iterator to be used for next and previous page requests.

    • exhausted - Indicates if more results are available for potential next page request. Supported values are "y" (yes) or "n" (no).

{
 "iterator_status" : "T2pFd0xFTTdNVEE3TVRBd0xqQT0K",
 "exhausted" : "n",
 "places" : [ {
   "name" : "Pacific Park Market",
   "distance" : 359.215,
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.55922,
       "longitude" : -117.72512
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27792 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "27792",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Liquor Stores",
     "code" : "AKO",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "8310330",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Quick Mart",
   "distance" : 1294.2313,
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57052,
       "longitude" : -117.72935
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "22952 Pacific Park Dr, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "22952",
     "state" : "CA",
     "street" : "Pacific Park Dr",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "7163600",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Mobil",
   "distance" : 1381.3029,
   "enhanced_contents" : {
     "business_url" : "http://mobil.com",
     "payment_method" : "American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56427,
       "longitude" : -117.71555
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27430 Alicia Pkwy, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27430",
     "state" : "CA",
     "street" : "Alicia Pkwy",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Car Wash",
     "code" : "ACJ",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 3.349,
     "units" : "G",
     "type" : "d",
     "currency" : "USD"
   }, {
     "value" : 2.989,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 3.099,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.199,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4251187",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Ralphs",
   "distance" : 1442.9886,
   "enhanced_contents" : {
     "business_url" : "http://ralphs.com",
     "hours_of_operation_text" : "Daily, 6am - 1am",
     "parking" : "Free lot, On-street: free",
     "payment_method" : "Mastercard,Visa",
     "thumbnail_photo_url" : "http://o5.aolcdn.com/dims-shared/dims3/PATCH/resize/600x450/http://hss-prod.hss.aol.com/hss/storage/patch/cbde11f5be18136c849a271e1bcb1ef0",
     "tips" : "You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit."
   },
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57149,
       "longitude" : -117.72528
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "26901 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "26901",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3623727",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Vons",
   "distance" : 1495.546,
   "enhanced_contents" : {
     "business_url" : "http://local.vons.com/ca/laguna-niguel-2508.html",
     "hours_of_operation_text" : "Daily 5am-1am",
     "payment_method" : "Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56607,
       "longitude" : -117.71534
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27320 Alicia Pkwy, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27320",
     "state" : "CA",
     "street" : "Alicia Pkwy",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Liquor Stores",
     "code" : "AKO",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Florists",
     "code" : "AKL",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Bakeries",
     "code" : "AEOG",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Restaurants",
     "code" : "AE",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Sandwiches",
     "code" : "AEYM",
     "parent_category" : {
       "code" : "AE",
       "name" : "Restaurants"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4489244",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "76",
   "distance" : 1594.5978,
   "enhanced_contents" : {
     "business_url" : "http://76.com",
     "payment_method" : "American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Aliso Viejo",
     "coordinate" : {
       "latitude" : 33.57263,
       "longitude" : -117.72408
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "26871 Aliso Creek Rd, Aliso Viejo, CA 92656, USA",
     "postal" : "92656",
     "house_number" : "26871",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Car Wash",
     "code" : "ACJ",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.979,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 3.079,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.179,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "4251559",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Whole Foods Market",
   "distance" : 1599.0155,
   "enhanced_contents" : {
     "business_url" : "http://wholefoodsmarket.com",
     "hours_of_operation_structured" : [ {
       "day_of_the_week" : "0",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "1",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "2",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "3",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "4",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "5",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     }, {
       "day_of_the_week" : "6",
       "hours" : [ {
         "end_time" : "79200",
         "start_time" : "25200"
       } ]
     } ],
     "hours_of_operation_text" : "Daily 7am-10pm"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.55545,
       "longitude" : -117.71224
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "23932 Aliso Creek Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "23932",
     "state" : "CA",
     "street" : "Aliso Creek Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "9005830",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Ralphs",
   "distance" : 1762.652,
   "enhanced_contents" : {
     "business_url" : "http://ralphs.com",
     "features" : "Greeting cards|Flowers|Household essentials|Food and drink|Ice|Beer|Toys|Newspapers/magazines|Tobacco products",
     "hours_of_operation_text" : "Daily, 5 a.m. - 1 a.m",
     "parking" : "Free lot",
     "payment_method" : "Mastercard,Visa",
     "thumbnail_photo_url" : "http://o4.aolcdn.com/dims-shared/dims3/PATCH/resize/600x450/http://hss-prod.hss.aol.com/hss/storage/patch/cc0b52559c5fe46b0bad29f90eaa030d",
     "tips" : "You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit.|You can order many grocery items from the Ralphs website and have them delivered to your door via UPS.|Sign up for a Ralphs Club Card and receive discounts on selected items throughout the store. On average, customers save 20 percent per shopping trip. Other programs provide savings for seniors and those who frequently buy wine or pet items.|Prescriptions can be ordered online and picked up at the store. Or, if you only have a few items and want to avoid long lines, the self-service checkouts allow you to scan your own items for a faster exit."
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.55766,
       "longitude" : -117.71003
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27871 La Paz Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27871",
     "state" : "CA",
     "street" : "La Paz Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Food Markets",
     "code" : "AKJ",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3625921",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Costco Pharmacy",
   "distance" : 1873.285,
   "enhanced_contents" : {
     "business_url" : "http://costco.com",
     "hours_of_operation_text" : "Mon - Fri, 10am - 8:30pm; Sat, 9:30am - 6pm; Sun, 10am - 6pm; Pharmacy, Mon - Fri, 10am - 7pm; Sat, 9:30am - 6pm; Sun, closed",
     "payment_method" : "Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56817,
       "longitude" : -117.71212
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27220 Heather Ridge Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27220",
     "state" : "CA",
     "street" : "Heather Ridge Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Wholesale Clubs",
     "code" : "AKX",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Department Stores",
     "code" : "AKC",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Pharmacies",
     "code" : "ANC",
     "parent_category" : {
       "code" : "AN",
       "name" : "Health Care"
     }
   }, {
     "name" : "Office Supplies",
     "code" : "AKV",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Houseware Stores",
     "code" : "AKU",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Furniture Stores",
     "code" : "AKT",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Clothing Stores",
     "code" : "AKI",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Shopping/Retail",
     "code" : "AK",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Retail Shops",
     "code" : "AKF",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.699,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 2.899,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "3898702",
     "country" : "1",
     "area" : "949"
   } ]
 }, {
   "name" : "Arco",
   "distance" : 1984.6416,
   "enhanced_contents" : {
     "business_url" : "http://arco.com",
     "hours_of_operation_text" : "Daily 24 Hours",
     "payment_method" : "cash,checks,Debit Card,American Express,Discover,Mastercard,Visa"
   },
   "location" : {
     "city" : "Laguna Niguel",
     "coordinate" : {
       "latitude" : 33.56402,
       "longitude" : -117.70848
     },
     "country_code" : "USA",
     "country" : "USA",
     "formatted_address" : "27491 La Paz Rd, Laguna Niguel, CA 92677, USA",
     "postal" : "92677",
     "house_number" : "27491",
     "state" : "CA",
     "street" : "La Paz Rd",
     "type" : "street"
   },
   "categories" : [ {
     "name" : "Grocery Stores",
     "code" : "AKD",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   }, {
     "name" : "Gas Stations",
     "code" : "ACC",
     "parent_category" : {
       "code" : "AC",
       "name" : "Automotive"
     }
   }, {
     "name" : "Convenience Stores",
     "code" : "AKB",
     "parent_category" : {
       "code" : "AK",
       "name" : "Shopping/Retail"
     }
   } ],
   "fuel_price" : [ {
     "value" : 2.839,
     "units" : "G",
     "type" : "r",
     "currency" : "USD"
   }, {
     "value" : 2.939,
     "units" : "G",
     "type" : "m",
     "currency" : "USD"
   }, {
     "value" : 3.039,
     "units" : "G",
     "type" : "p",
     "currency" : "USD"
   } ],
   "phones" : [ {
     "type" : "primary",
     "number" : "8310543",
     "country" : "1",
     "area" : "949"
   } ]
 } ]
}